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

# Pagination

> How SendyKit paginates list-style API responses

## Envelope shape

List responses use a JSON envelope with `data` and `meta`.

```json theme={null}
{
  "data": [],
  "meta": {
    "page": 1,
    "per_page": 25,
    "total": 142
  }
}
```

## Common query params

Typical pagination params:

* `page`
* `per_page`

## Why it matters

SendyKit is meant to be usable by:

* humans
* scripts
* agents

That means responses need predictable pagination and metadata instead of ad-hoc raw dumps.