Overview
All list endpoints return paginated results. The Anton API uses cursor-based pagination withlimit and cursor query parameters.
Parameters
| Parameter | Type | Default | Max | Description |
|---|---|---|---|---|
limit | integer | 20 | 100 | Number of items to return |
cursor | string | — | — | Opaque cursor from a previous response. Omit to start from the beginning. |
Response format
Every list response includes ahas_more boolean. When has_more is true, a next_cursor string is also present:
| Field | Description |
|---|---|
data | Array of results for this page |
has_more | true if more results exist beyond this page |
next_cursor | Cursor to pass in the next request. Only present when has_more is true. |
has_more is false and next_cursor is not included:
Iterating through pages
Pass thenext_cursor value from each response as the cursor parameter in the next request:
Tips
Use the maximum page size
Use the maximum page size
Set
limit=100 to minimize the number of API calls when fetching all items.Stop when has_more is false
Stop when has_more is false
The
has_more field tells you whether another page exists. When it is false, you have reached the end of the result set.Cursors are opaque
Cursors are opaque
Treat cursor values as opaque strings. Do not parse, modify, or construct them. Always use the exact
next_cursor value returned by the API.Cursors do not expire
Cursors do not expire
Cursor values remain valid indefinitely. You can store a cursor and resume pagination later.