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

# Pagination

> List endpoints are paginated with page and limit.

List endpoints return a `pagination` object alongside `data`. Control the page with
`page` (1-based) and the page size with `limit` (default `25`, max `100`).

```bash theme={null}
curl "https://api.referralful.com/v1/affiliates?page=2&limit=50" \
  -u rfl_live_your_secret:
```

```json theme={null}
{
  "pagination": {
    "previous_page": 1,
    "current_page": 2,
    "next_page": 3,
    "count": 50,
    "limit": 50,
    "total_pages": 4,
    "total_count": 180
  },
  "data": [ ]
}
```

When `next_page` is `null`, you've reached the last page.