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. |
GET /v1/clusters?limit=50
Authorization: Bearer $ALC_API_KEYEvery 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.