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

# Pagination

> How pagination works for all list endpoints

All list endpoints return paginated responses.

## Query parameters

| Param      | Type    | Default | Range            |
| ---------- | ------- | ------- | ---------------- |
| `page`     | integer | 1       | min: 1           |
| `per_page` | integer | 20      | min: 1, max: 100 |

## Response format

```json theme={null}
{
  "data": [ ... ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 150,
    "total_pages": 8
  }
}
```

## Example

```bash theme={null}
# Page 1
curl "https://vvdufluovypptsnkihyv.supabase.co/functions/v1/consumers?page=1&per_page=50" \
  -H "x-api-key: sk_test_your_api_key_here"

# Page 2
curl "https://vvdufluovypptsnkihyv.supabase.co/functions/v1/consumers?page=2&per_page=50" \
  -H "x-api-key: sk_test_your_api_key_here"
```

Continue incrementing `page` until `page > total_pages`.

## Paginated endpoints

* `GET /consumers`
* `GET /tradelines`
* `GET /payments` (requires `tradeline_id`)
* `GET /submissions`

<Note>Single-resource endpoints (`GET /consumers/:id`, `GET /tradelines/:id`, etc.) return the object directly without a `data` wrapper.</Note>