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

# Pagination

> How cursor-based pagination works

# Pagination

All list endpoints use **cursor-based pagination** for reliable traversal of large datasets.

## How It Works

```bash theme={null}
# First page
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.aniquotes.myproj.xyz/api/v1/quotes?limit=20"

# Next page (use the cursor from the previous response)
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.aniquotes.myproj.xyz/api/v1/quotes?limit=20&cursor=eyJpZCI6..."
```

## Response Format

```json theme={null}
{
  "status": "success",
  "data": [...],
  "pagination": {
    "cursor": "eyJpZCI6...",
    "has_more": true,
    "total": 1420
  }
}
```

## Parameters

| Param    | Type   | Default | Max | Description                              |
| -------- | ------ | ------- | --- | ---------------------------------------- |
| `limit`  | int    | 20      | 50  | Number of results per page               |
| `cursor` | string | —       | —   | Pagination cursor from previous response |

## Tips

* When `has_more` is `false`, you've reached the end of the dataset
* Cursors are **opaque** — don't parse or modify them
* The `total` field may be `null` for performance reasons on very large sets