Pagination

When querying for a list of objects, you will receive a format like this:

Copy
{ "total": 15646, "list": [ { "id": "bd4a0997-39db-41d9-883a-cdfa83e2101f", ... }, ... ] }

Where total is the total number of objects that are available and list is the list of objects that are returned.

Parameters

ParameterTypeDefaultDescription
limitnumber1000The maximum number of objects to return per request. Must be between 1 and 1000.
offsetnumber0The number of objects to skip before returning results. Use this to paginate through large result sets.

Limit

The default limit is 1000 objects per request, which is also the maximum. You can use the limit parameter to request fewer objects per request.

For example, to retrieve only 10 objects:

GET /tickets?limit=10

Offset

If the total number of objects exceeds the limit, you can use the offset parameter to paginate through the results.

For example, if you have 2500 objects and use the default limit of 1000:

  • First request: GET /tickets returns objects 1-1000
  • Second request: GET /tickets?offset=1000 returns objects 1001-2000
  • Third request: GET /tickets?offset=2000 returns objects 2001-2500

You can combine limit and offset:

GET /tickets?limit=50&offset=100

This returns 50 objects, starting from the 101st object.

Previous
Overview
Next
Querying