Skip to Content

Pagination

Page through list operations with limit and cursor.

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

ParameterMeaning
limitPage size, 1 to 100. The default is 25.
cursorThe next_cursor of the previous page. Omit it for the first page.
GET /v1/clusters?limit=50
Authorization: Bearer $ALC_API_KEY

Every page has the same shape:

{
  "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.