Pagination
Retrieve collections and export larger datasets.
Request a page
Collection endpoints return aresults array and pagination information in meta. Use these query parameters:
| Parameter | Default | Meaning |
|---|---|---|
page | 1 | Page number, starting at 1. |
per_page | 20 | Number of results per page, up to 200. |
curl --get 'https://api.siit.io/v1/requests' \
--header "Authorization: Bearer $SIIT_API_KEY" \
--data-urlencode 'page=1' \
--data-urlencode 'per_page=100'
SIIT_API_KEY to your API key in your local environment. The endpoint reference lists its available filters and sorting options.
Read the response
For example, a query with no matching requests returns:{
"results": [],
"meta": {
"count": 0,
"total": 0,
"current_page": 1,
"per_page": 100,
"next_page_link": null,
"previous_page_link": null
}
}
count is the number of results in this response; total is the number matching the query across pages.
When meta.next_page_link is not null, request that URL with the same Authorization header. The link preserves your filters and page size. Continue until next_page_link is null. previous_page_link is null on the first page.
Export larger datasets
The API rejects a request with HTTP400 when page × per_page exceeds 100,000. For example, page 501 with per_page=200 is outside the supported range.
Split larger exports using the endpoint’s supported timestamp filters or other filters, then paginate each subset separately. For a bounded request export:
curl --get 'https://api.siit.io/v1/requests' \
--header "Authorization: Bearer $SIIT_API_KEY" \
--data-urlencode 'created_after=2026-01-01T00:00:00Z' \
--data-urlencode 'created_before=2026-02-01T00:00:00Z' \
--data-urlencode 'per_page=200'
updated_after where supported. Collections can change while you paginate; use overlapping synchronization windows and deduplicate rather than treating pages as a fixed snapshot.
Observe the rate limit when fetching successive pages.
The meta object
{
"count": 123,
"current_page": 123,
"next_page_link": "<string>",
"per_page": 20,
"previous_page_link": "<string>",
"total": 123
}