Pagination, sorting, and meta information

This guides explains how pagination, sorting, and meta information works and how they can be used.


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 parameterPurpose
limitNumber of items per response. Maximum allowed is 10000. Default is 1000
offsetOffset 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).


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 parameterPurpose
sortField name of the single resource by which a list is to be sorted.
orderSorting 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 nameDescription
offsetQuantity of resource to be offset in the response.
limitTotal limit of the response.
countNumber of resources returned in the response.
total_countTotal number of all resources.
sortField by which a list is sorted.
orderSorting order of the response (ASC or DESC).

Was this page helpful?