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

# Pagination

> Cursor-based pagination for list endpoints

List endpoints return paginated results using cursor-based pagination. Cursors are opaque strings — don't parse or construct them yourself.

## Parameters

| Parameter | Default | Description                                    |
| --------- | ------- | ---------------------------------------------- |
| `limit`   | 50      | Number of results per page (1–100)             |
| `cursor`  | —       | Cursor from a previous response's `nextCursor` |

`GET /customers` is the exception — its `limit` defaults to 20.

## Response structure

Every list response includes pagination metadata in `meta`:

```json theme={null}
{
  "data": [...],
  "meta": {
    "pagination": {
      "hasMore": true,
      "nextCursor": "cur_eyJ2IjoxLC..."
    }
  }
}
```

* **`hasMore`** — `true` if additional results exist beyond this page
* **`nextCursor`** — Pass this as the `cursor` query parameter to fetch the next page. `null` when `hasMore` is `false`.

## Related

* [About the Natural API](/api-reference/about) — Response structure and JSON:API format