# API pagination | Orion Data API v1.3

> For the complete documentation index, see [llms.txt](https://docs.oriondata.io/llms.txt)

How to page through large result sets using the offset query parameter.

Endpoints that can return large result sets are paginated. Pagination is controlled by the `offset` query parameter.

## How pagination works

- `offset` is the page number to return, starting at `0`.
- Each page contains up to 100 records.
- Increase `offset` by one to retrieve the next page.
- When a request returns an empty array, you have reached the end of the available data.

## Example

Retrieve the first page of results:

```bash
curl -X GET "https://api.oriondata.io/api/sensorData?startDate=2024-09-09&endDate=2024-09-16&offset=0&sensorIds=54321" \
  -H "Authorization: Bearer $TOKEN"
```

Retrieve the next page by incrementing `offset`:

```bash
curl -X GET "https://api.oriondata.io/api/sensorData?startDate=2024-09-09&endDate=2024-09-16&offset=1&sensorIds=54321" \
  -H "Authorization: Bearer $TOKEN"
```

Continue incrementing `offset` until the response is an empty array `[]`.

> **Tip:**
>
> When extracting large date ranges, walk the offsets sequentially. Parallel calls increase the chance of hitting the [rate limit](https://docs.oriondata.io/api/orion-data/v1-3/guides/rate-limiting/).