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

# Pagination

> List endpoints return newest first with an opaque cursor that stays stable while new rows arrive.

List endpoints that can grow without bound (`GET /v1/emails`, `GET /v1/suppressions`, `GET /v1/webhooks/{id}/deliveries`) are cursor-paged. Short lists (`GET /v1/domains`, `GET /v1/templates`, `GET /v1/webhooks`) return everything under `data`.

## Request

| Parameter | Meaning |
| - | - |
| `limit` | Rows per page. Emails: 1 to 100, default 50. Suppressions and deliveries: 1 to 200, default 50. |
| `cursor` | The `nextCursor` from the previous response. Omit for the first page. |

## Response

```json theme={"dark"}
{
  "data": [ { "id": "em_01j9...", "...": "..." } ],
  "nextCursor": "MjAyNi0xMC0yN1QwOToxMjo0MS4wMDBafGVtXzAxajl4..."
}
```

`nextCursor` is `null` on the last page. Cursors are opaque; do not build or edit them. A cursor the API did not issue is `422 validation_error`.

## Walking every page

```ts Node.js theme={"dark"}
let cursor: string | undefined;
do {
  const page = await sendbaze.emails.list({ status: "bounced", limit: 100, cursor });
  for (const email of page.data) console.log(email.id, email.to);
  cursor = page.nextCursor ?? undefined;
} while (cursor);
```

```python Python theme={"dark"}
cursor = None
while True:
    params = {"status": "bounced", "limit": 100}
    if cursor:
        params["cursor"] = cursor
    page = requests.get("https://api.sendbaze.com/v1/emails", headers=headers, params=params).json()
    for email in page["data"]:
        print(email["id"], email["to"])
    cursor = page["nextCursor"]
    if not cursor:
        break
```

Pages are ordered by creation time, newest first, and keyed on `(createdAt, id)`, so rows that arrive while you paginate never shift the ones you have already seen.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.