> Index of every page on this site: [llms.txt](https://docs.a-line.cloud/llms.txt)

# Pagination

> Page through list operations with limit and cursor.

List operations return one page at a time. Two query parameters control it:

| Parameter | Meaning                                                    |
| --------- | ---------------------------------------------------------- |
| `limit`   | Page size, 1 to 100. The default is 25.                     |
| `cursor`  | The `next_cursor` of the previous page. Omit it for the first page. |

```http api
GET /v1/clusters?limit=50
Authorization: Bearer $ALC_API_KEY
```

Every page has the same shape:

```json api op=list_clusters status=200
{
  "data": [
    {
      "id": "5b1f0a52-8c4e-4d1b-9a77-2f6c3e8d1a40",
      "name": "production",
      "provider": "hetzner",
      "region": "fsn1",
      "state": "running",
      "environment_id": "a3c2d9e8-1b7f-4e60-8d5a-6c4b2e1f0a93",
      "created_at": "2026-10-01T09:30:00Z",
      "capacity_wait": [],
      "price_confirmation": []
    }
  ],
  "has_more": true,
  "next_cursor": "eyJpZCI6IjViMWYwYTUyIn0"
}
```

Pass `next_cursor` as `cursor` to get the next page. On the last page
`has_more` is `false` and `next_cursor` is `null`. Treat the cursor as opaque:
do not build or change it. A `limit` out of range or a malformed `cursor` is
refused with `400`.
