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

# Pagination

> Navigate through large result sets

# Pagination

List endpoints return paginated results. Use `page` and `limit` query parameters to control the response.

## Parameters

| Parameter | Type    | Default | Description               |
| --------- | ------- | ------- | ------------------------- |
| `page`    | integer | `1`     | Page number (1-indexed)   |
| `limit`   | integer | `20`    | Items per page (max: 100) |

## Example

```bash theme={null}
curl -X GET "https://api.nevatal.com/api/v1/patients?page=2&limit=10" \
  -H "Authorization: Bearer nvtl_your_api_key"
```

## Response format

All paginated responses include a `pagination` object:

```json theme={null}
{
  "data": [...],
  "pagination": {
    "page": 2,
    "limit": 10,
    "total": 142,
    "totalPages": 15
  }
}
```

## Best practices

* Use reasonable page sizes (10-50 items) for most use cases
* Cache responses when possible to reduce API calls
* Use the `total` field to build pagination UI or detect when you've fetched everything