Pagination

For queries that return large result sets, the API uses offset-based pagination with skip and limit request attributes.

• skip specifies how many items to offset (skip) from the beginning of the result set.
• limit specifies the maximum number of items to return in a single request.

Defaults and limits:

• Default page size varies by dimension. Default for time dimension is 1500 items. All other dimensions default to 10 items.
• Maximum limit is 1500 for the time dimension and 1000 for all other dimensions.

How pagination works:

• Start with skip=0 and a desired limit (for example, limit=1000).
• Retrieve the next page by increasing skip by the value of limit:
• First page: skip=0, limit=1000
• Second page: skip=1000, limit=1000
• Third page: skip=2000, limit=1000
• Continue paging until fewer items than the specified limit are returned.

Additional details:

• The response includes a pagination object containing the total number of available items.
• Results can be sorted using the sort parameter, for example time:asc or time:desc. For consistent pagination, use a deterministic sort order.