> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexrex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Pagination

> How list endpoints page results.

List endpoints accept two query parameters:

| Parameter | Default | Max | Meaning                   |
| --------- | ------- | --- | ------------------------- |
| `limit`   | 50      | 100 | Number of items to return |
| `offset`  | 0       | —   | Number of items to skip   |

```bash theme={null}
curl "https://api.nexrex.ai/api/v1/developer/v1/athletes?limit=25&offset=50" \
  -H "Authorization: Bearer nrx_prod_your_key_here"
```

The athlete roster response includes a `total`, so you can page to completion:

```json theme={null}
{
  "success": true,
  "data": {
    "athletes": [ /* … */ ],
    "total": 132,
    "limit": 25,
    "offset": 50
  }
}
```

Increase `offset` by `limit` until `offset + limit >= total`.

<Note>
  The activity list is scoped by `athlete_id` and date range rather than a running
  total. Page it by advancing `offset` until a page returns fewer than `limit`
  items, or narrow the `start_date` / `end_date` window.
</Note>

Non-integer `limit` or `offset` values return `400` with code `validation_error`.
`limit` is clamped to a maximum of 100.