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

# Pagination

> How to paginate through list endpoints

Collection endpoints return paginated results using offset pagination. Pass `page` and `limit` as query parameters.

```bash Bash theme={null}
curl -X GET 'https://api.cadanapay.com/v1/persons?page=1&limit=20' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

***

## Request Parameters

| Parameter | Type    | Default | Description                           |
| :-------- | :------ | :------ | :------------------------------------ |
| `page`    | integer | `1`     | Page number to retrieve (starts at 1) |
| `limit`   | integer | `20`    | Items per page (1–100)                |

***

## Response Format

All list endpoints return a `data` array and a `meta` object:

```json JSON theme={null}
{
  "data": [
    { "id": "7dd569f9-bd54-4fbb-a5c2-f0aaadc68adf", "..." : "..." },
    { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "..." : "..." }
  ],
  "meta": {
    "limit": 20,
    "currentPage": 1,
    "itemCount": 45,
    "pages": 3,
    "skipped": 0
  }
}
```

## Meta Fields

| Field         | Type   | Description                                         |
| :------------ | :----- | :-------------------------------------------------- |
| `limit`       | number | Items per page (from request, default 20)           |
| `currentPage` | number | Current page number                                 |
| `itemCount`   | number | Total items across all pages                        |
| `pages`       | number | Total number of pages                               |
| `skipped`     | number | Number of records skipped to reach the current page |