# Pagination

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

Version: 3.0.0