API reference

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.

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

Last modified on August 2, 2026

⌘I

Getting started

Core concepts

Requests and reliability

Resources