> ## Documentation Index
> Fetch the complete documentation index at: https://docs.galadriel.co/llms.txt
> Use this file to discover all available pages before exploring further.

# List Leases

> List all leases for your account

## Query Parameters

<ParamField query="status" type="string">
  Filter by status: `active`, `expired`, or `all`
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Number of leases to return (max: 100)
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Number of leases to skip
</ParamField>

## Response

<ResponseField name="leases" type="array">
  Array of lease objects
</ResponseField>

<ResponseField name="total" type="integer">
  Total number of leases matching the filter
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.galadriel.com/v1/leases?status=active" \
    -H "Authorization: Bearer YOUR_API_TOKEN"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.galadriel.com/v1/leases",
      headers={"Authorization": "Bearer YOUR_API_TOKEN"},
      params={"status": "active"}
  )

  leases = response.json()["leases"]
  for lease in leases:
      print(f"{lease['lease_id']}: {lease['gpu_count']}x {lease['gpu_type']}")
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.galadriel.com/v1/leases?status=active',
    {
      headers: {
        'Authorization': 'Bearer YOUR_API_TOKEN'
      }
    }
  );

  const data = await response.json();
  data.leases.forEach(lease => {
    console.log(`${lease.lease_id}: ${lease.gpu_count}x ${lease.gpu_type}`);
  });
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "leases": [
      {
        "lease_id": "lse_xyz123",
        "customer_id": "alice",
        "gpu_type": "h100",
        "gpu_count": 16,
        "instance_type": "16xh100",
        "zone": "us-west-1",
        "status": "active",
        "rate": 1.40,
        "start_time": "2025-11-11T14:00:00Z",
        "end_time": "2025-11-12T14:00:00Z",
        "created_at": "2025-11-11T14:00:00Z"
      },
      {
        "lease_id": "lse_abc456",
        "customer_id": "alice",
        "gpu_type": "h200",
        "gpu_count": 8,
        "instance_type": "8xh200",
        "zone": "us-east-1",
        "status": "active",
        "rate": 4.50,
        "start_time": "2025-11-11T10:00:00Z",
        "end_time": "2025-11-12T10:00:00Z",
        "created_at": "2025-11-11T10:00:00Z"
      }
    ],
    "total": 2,
    "limit": 20,
    "offset": 0
  }
  ```
</ResponseExample>