# Pagination

> Working with paginated API responses

## Overview

All list endpoints support pagination using `limit` and `offset` parameters.

## Parameters

<ParamField query="limit" type="integer" default="50">
  Maximum results per page (max: 100)
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Number of results to skip
</ParamField>

## Example

```bash
GET /api/v1/leads?limit=50&offset=100
```

## Response Format

```json
{
  "data": [...],
  "pagination": {
    "limit": 50,
    "offset": 100,
    "total": 500
  }
}
```

## Best Practices

- Use reasonable page sizes (50-100 items)
- Cache results when possible
- Implement cursor-based pagination for large datasets