> ## 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.

# API reference

> The complete receive-only v1 operation surface.

The Reference tab is generated from the repository's normative OpenAPI 3.1 contract. Public v1 contains exactly these operations:

| Method | Path                                                    | Purpose                                |
| ------ | ------------------------------------------------------- | -------------------------------------- |
| `GET`  | `/v1/domains`                                           | List domains available to the account. |
| `POST` | `/v1/emails`                                            | Create a temporary email reservation.  |
| `GET`  | `/v1/emails/{email_id}`                                 | Read one owned email reservation.      |
| `GET`  | `/v1/emails/{email_id}/messages`                        | List current messages for an email.    |
| `GET`  | `/v1/messages/{message_id}`                             | Read parsed message content.           |
| `GET`  | `/v1/messages/{message_id}/source`                      | Download raw RFC 822 source.           |
| `GET`  | `/v1/messages/{message_id}/attachments/{attachment_id}` | Download one attachment.               |
| `GET`  | `/v1/usage`                                             | Read current account usage.            |

There are no public v1 endpoints for outbound email, deletion, webhooks, WebSockets, or background polling. Use the Reference tab for parameters, schemas, response headers, error codes, and language examples in cURL, JavaScript, Python, and PHP.

<Note>
  The pre-launch reference is non-interactive. It never asks for, stores, or
  proxies an API key from the documentation site.
</Note>