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

# API v1 pagination

> Page through API v1 list responses.

API v1 uses offset pagination on list endpoints.

| Parameter | Default | Maximum | Description                  |
| --------- | ------: | ------: | ---------------------------- |
| `max`     |    `10` |   `100` | Number of records to return. |
| `offset`  |     `0` |       - | Number of records to skip.   |

```bash theme={null}
curl \
  -H "Authorization: Bearer <API_KEY>" \
  "https://spaportal.cz/api/v1/hotels?max=10&offset=20"
```

Read the `X-Total-Count` response header to get the total number of matching
records.

Some nested list responses also support `max_nested`. Its default is `10` and
maximum is `100`.