Pagination
How pagination works across Informly API endpoints
All list endpoints in the Informly API return paginated results. This keeps responses fast and predictable, regardless of how many records you have.
How it works
You control pagination with two query parameters:
| Parameter | Default | Range | Description |
|---|---|---|---|
page | 1 | 1+ | Which page to retrieve |
pageSize | 20 | 1–100 | How many items per page |
Response metadata
Every paginated response includes a meta object alongside the data array:
{
"data": [ ... ],
"meta": {
"total": 152,
"page": 2,
"pageSize": 20,
"totalPages": 8
}
}| Field | Description |
|---|---|
total | Total number of items across all pages |
page | The current page number |
pageSize | Items per page |
totalPages | Total number of pages |
Use totalPages to know when you've reached the end of the results.
Tips
- Start with the default
pageSizeof 20. Increase to 100 only if you need to minimize round-trips. - To iterate through all records, increment
pageuntil it exceedstotalPages. - The
totalcount reflects all matching records, not just the current page.
Last updated on