Pagination, sorting, and meta information
This guides explains how pagination, sorting, and meta information works and how they can be used.
Pagination
Endpoints that expose lists of resources may be paginated. This means that if there are many resources, they can be retrieved in segments divided into pages rather than in a single result. See API reference for details.
A common method of paginating is to use the following query parameters:
Query parameter | Purpose |
---|---|
limit |
Number of items per response. Maximum allowed is 10000 . Default is 1000 |
offset |
Offset value in the main list at which the maximum of limit items from the list should be returned. Default is 0 |
If you do not specify either of these parameters, you will get a list with a maximum of 1000 entries and an offset of 0 (i.e. the beginning of the list).
Sorting
Some endpoints allow you to define the sorting order of the returned list. Each endpoint specifies the allowed fields by which lists can be sorted. Check API reference for more details.
Query parameter | Purpose |
---|---|
sort |
Field name of the single resource by which a list is to be sorted. |
order |
Sorting order. Either ASC or DESC for ascending or descending sorting order respectively. Default is ASC . |
Meta information
Each endpoint that allows pagination contains a response with the fields meta
and data
.
The meta
field contains relevant meta information about the returned list.The data
field contains all resource information defined in the endpoint descriptions section.
The meta
field for a list of resources contains the following information:
Field name | Description |
---|---|
offset |
Quantity of resource to be offset in the response. |
limit |
Total limit of the response. |
count |
Number of resources returned in the response. |
total_count |
Total number of all resources. |
sort |
Field by which a list is sorted. |
order |
Sorting order of the response (ASC or DESC ). |
Was this page helpful?