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

# Pagination

> Read one bounded page at a time.

List operations accept `limit` and `cursor`. The default page size is 25; the maximum is 100. Keep endpoint-specific filters unchanged between pages.

```json theme={null}
{"data": [], "has_more": false, "next_cursor": null}
```

**1. Fetch the first page**

Call the list endpoint with your filters and `limit=25`, without a cursor.

**2. Store the returned records**

Use stable resource IDs, keeping workspace and channel in your mapping.

**3. Continue only when needed**

If `has_more` is true, pass the returned `next_cursor` as `cursor` to the same endpoint with the same filters. Stop when false.

## Cursor semantics

Treat cursors as opaque. Do not decode, edit or reuse them on another path. Results use ascending IDs; pagination is not a snapshot or a change feed. Records may change between pages, so make your sync tolerant of overlap and updates.

Unknown or repeated parameters are rejected. The CLI and MCP return one page per call, with no automatic crawl. Their response cap is 512 KiB; reduce the page size if saved message content makes a response too large.


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