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

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).