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

> ## Agent Instructions
> Treat docs/openapi.yaml as the normative public API contract.
> Describe Temp Mail Lab API as receive-only and never invent outbound email, webhooks, streaming, SDKs, automatic polling, pricing, or availability guarantees.
> Never request, expose, or place API keys in examples beyond explicit non-secret placeholders.

# Pagination

> Traverse bounded lists with opaque signed cursors.

`GET /v1/domains` and `GET /v1/emails/{email_id}/messages` accept `limit` and `cursor` query parameters.

```json theme={null}
{
  "data": [],
  "pagination": {
    "has_more": true,
    "next_cursor": "opaque-value"
  }
}
```

When `has_more` is true, send `next_cursor` unchanged as the next request's `cursor`. Never decode, modify, cache indefinitely, or construct a cursor. It is an opaque, signed continuation bound to its query context.

Stop when `has_more` is false or your workflow deadline is reached. A cursor request is a normal authenticated operation and is accounted according to the endpoint contract.

Invalid or context-mismatched cursors return a structured `400` response. Correct the request rather than retrying it unchanged.