Overview
All list endpoints return paginated results. The Anton API uses offset-based pagination withlimit and offset query parameters.
Parameters
| Parameter | Type | Default | Max | Description |
|---|---|---|---|---|
limit | integer | 20 | 100 | Number of items per page |
offset | integer | 0 | — | Number of items to skip |
Response format
Every list response includes apagination object:
| Field | Description |
|---|---|
total | Total number of items matching your query |
limit | Items per page (echoes your request) |
offset | Current offset (echoes your request) |
Iterating through pages
To get the next page, incrementoffset by limit:
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.Check total before iterating
Check total before iterating
The
total field tells you how many pages you’ll need. Use it to display progress or estimate completion time.Don't paginate past the end
Don't paginate past the end
Stop when
offset + limit >= total. Requesting an offset beyond the total returns an empty data array.