> ## Documentation Index
> Fetch the complete documentation index at: https://yn-c9bb3266.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Pagination

> Cursor-based pagination for every list endpoint.

Every Yuno list endpoint (`GET /v1/customers`, `/v1/recipients`, `/v1/reports`, etc.) uses the same cursor model — the parameters and response shape do not vary across resources. Lists return at most 20 records by default. The model is the same one Stripe uses.

| Parameter        | Type                 | Default | Purpose                                                        |
| ---------------- | -------------------- | ------- | -------------------------------------------------------------- |
| `limit`          | integer              | `20`    | Records per page (max 100).                                    |
| `starting_after` | string (resource id) | —       | Return results immediately **after** this id (next page).      |
| `ending_before`  | string (resource id) | —       | Return results immediately **before** this id (previous page). |

```bash theme={"theme":{"light":"github-dark","dark":"github-dark"}}
# Page 1
curl "https://api-sandbox.y.uno/v1/customers?limit=20" \
  -H "public-api-key: $YUNO_PUBLIC_API_KEY" \
  -H "private-secret-key: $YUNO_PRIVATE_SECRET_KEY"

# Page 2 — pass the id of the last record from page 1
curl "https://api-sandbox.y.uno/v1/customers?limit=20&starting_after=cust_01HX..." \
  -H "public-api-key: $YUNO_PUBLIC_API_KEY" \
  -H "private-secret-key: $YUNO_PRIVATE_SECRET_KEY"
```

Use `starting_after` to walk forward through results. Stop when the response returns fewer than `limit` records.