> ## 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.

# Get Lease

> Retrieve details of a specific lease

## Path Parameters

<ParamField path="lease_id" type="string" required>
  The lease ID to retrieve
</ParamField>

## Response

<ResponseField name="lease_id" type="string">
  Unique lease identifier
</ResponseField>

<ResponseField name="status" type="string">
  Lease status: `active` or `expired`
</ResponseField>

<ResponseField name="nodes" type="array">
  Array of node hostnames
</ResponseField>

<ResponseField name="ssh_endpoints" type="array">
  Array of SSH connection strings
</ResponseField>

<ResponseField name="namespace" type="string">
  Kubernetes namespace for this lease
</ResponseField>

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

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

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

  lease = response.json()
  print(f"Status: {lease['status']}")
  print(f"Nodes: {', '.join(lease['nodes'])}")
  ```

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

  const lease = await response.json();
  console.log(`Status: ${lease.status}`);
  console.log(`Nodes: ${lease.nodes.join(', ')}`);
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "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,
    "namespace": "customer-alice-lse-xyz123",
    "nodes": [
      "gpu-node-042",
      "gpu-node-043"
    ],
    "ssh_endpoints": [
      "customer@gpu-node-042.galadriel.com:22",
      "customer@gpu-node-043.galadriel.com:22"
    ],
    "start_time": "2025-11-11T14:00:00Z",
    "end_time": "2025-11-12T14:00:00Z",
    "created_at": "2025-11-11T14:00:00Z"
  }
  ```
</ResponseExample>