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

# Pagination

> Working with paginated API responses

## Overview

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

## Parameters

**limit** `integer` (default: 50)

Maximum results per page (max: 100)

**offset** `integer` (default: 0)

Number of results to skip

## Example

```bash theme={null}
GET /api/v1/leads?limit=50&offset=100
```

## Response Format

```json theme={null}
{
  "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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.