# Temp Mail Lab API > Build receive-only email workflows with the Temp Mail Lab API. > ## 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. ## Docs - [List available domains](https://docs.tempmaillab.com/api-reference/domains/list-available-domains.md): Returns domains visible to the authenticated account. This is a one-shot request and does not trigger background refreshes. A successful response, a 304 response, and an authenticated processed 400/404 response consume one request; 401, 403, 429, server errors, and health/internal traffic do not con… - [Create a temporary email](https://docs.tempmaillab.com/api-reference/emails/create-a-temporary-email.md): Atomically reserves a new address for 30 days. Omit local_part and domain to let the service select both, or provide either/both. The address starts receiving through the isolated API mail system immediately after the reservation becomes active; no website session, browser presence, or dashboard ava… - [Get an email](https://docs.tempmaillab.com/api-reference/emails/get-an-email.md): Returns an email owned by the authenticated account. Expired resources are not revived. An absent, expired, or unauthorized resource is represented by the same 404 shape to reduce enumeration. A 304 response is still charged. - [Download an attachment](https://docs.tempmaillab.com/api-reference/messages/download-an-attachment.md): Streams one attachment from private storage after validating the authenticated account, parent message, attachment identifier, and 15-minute expiry. Filenames never select an R2 object and downloads are always forced as attachments. A 304 response is still charged. - [Download raw message source](https://docs.tempmaillab.com/api-reference/messages/download-raw-message-source.md): Streams the original raw MIME from private storage after account ownership and 15-minute expiry checks. The response is never a permanent public URL, and raw content is not logged. A 304 response is still charged. - [Get a message](https://docs.tempmaillab.com/api-reference/messages/get-a-message.md): Returns parsed, safely rendered message content and attachment metadata. The authenticated account must own the parent email. An absent, expired, or unauthorized message returns the same 404 response. A 304 response is still charged. - [List messages for an email](https://docs.tempmaillab.com/api-reference/messages/list-messages-for-an-email.md): Returns non-expired messages for an email owned by the authenticated account. The service never calls this endpoint automatically. Messages disappear from reads 15 minutes after arrival even if physical cleanup is still running. A 304 response is still charged. - [Get current usage](https://docs.tempmaillab.com/api-reference/usage/get-current-usage.md): Returns only the authenticated account's current allowance and request consumption. Premium includes 10,000 requests per UTC calendar month; billing renewals do not reset that window. This endpoint does not consume the monthly request allowance. - [API Keys](https://docs.tempmaillab.com/developer-docs/api-keys.md): Create, scope, rotate, and revoke credentials safely. - [API reference](https://docs.tempmaillab.com/developer-docs/api-reference.md): The complete receive-only v1 operation surface. - [Attachments](https://docs.tempmaillab.com/developer-docs/attachments.md): Download private attachment bytes using opaque identifiers. - [Authentication](https://docs.tempmaillab.com/developer-docs/authentication.md): Use environment-bound bearer keys safely. - [Changelog](https://docs.tempmaillab.com/developer-docs/changelog.md): Public API contract changes. - [Core Concepts](https://docs.tempmaillab.com/developer-docs/core-concepts.md): Understand ownership, finite reads, retention, and receive-only behavior. - [Creating Emails](https://docs.tempmaillab.com/developer-docs/creating-emails.md): Reserve random or custom receiving addresses safely and idempotently. - [Domains](https://docs.tempmaillab.com/developer-docs/domains.md): Discover domains that your account can use for new addresses. - [Email Lifecycle](https://docs.tempmaillab.com/developer-docs/email-lifecycle.md): Understand reservation duration, message retention, and permanent non-reuse. - [Errors](https://docs.tempmaillab.com/developer-docs/errors-and-retries.md): Handle stable error envelopes and transient failures safely. - [FAQ](https://docs.tempmaillab.com/developer-docs/faq.md): Answers about lifecycle, polling, authentication, and environments. - [Getting Started](https://docs.tempmaillab.com/developer-docs/getting-started.md): Prepare a secure server-side integration before making your first request. - [Idempotency](https://docs.tempmaillab.com/developer-docs/idempotency.md): Retry email creation without creating duplicate reservations. - [Introduction](https://docs.tempmaillab.com/developer-docs/introduction.md): Receive temporary email through a private, finite REST API. - [Messages](https://docs.tempmaillab.com/developer-docs/messages.md): List message summaries and retrieve sanitized message content. - [Migration Guides](https://docs.tempmaillab.com/developer-docs/migration-guides.md): Plan upgrades while the public API contract evolves. - [Pagination](https://docs.tempmaillab.com/developer-docs/pagination.md): Traverse bounded lists with opaque signed cursors. - [Postman collection](https://docs.tempmaillab.com/developer-docs/postman.md): Import the maintained eight-operation v1 collection. - [Quickstart](https://docs.tempmaillab.com/developer-docs/quickstart.md): Create an address and retrieve its messages with cURL. - [Rate Limits](https://docs.tempmaillab.com/developer-docs/rate-limits.md): Handle commercial allowance, burst protection, and inbound safety separately. - [Raw Message Source](https://docs.tempmaillab.com/developer-docs/raw-message-source.md): Download original RFC 822 content through an authenticated finite request. - [Receive your first email](https://docs.tempmaillab.com/developer-docs/receive-first-email.md): A safe, bounded workflow from address creation to private content retrieval. - [Reliability best practices](https://docs.tempmaillab.com/developer-docs/reliability-best-practices.md): Build predictable finite receive workflows without hidden usage. - [Security Best Practices](https://docs.tempmaillab.com/developer-docs/security.md): Protect credentials and handle untrusted mail content. - [Usage and Quotas](https://docs.tempmaillab.com/developer-docs/usage-and-quotas.md): Read authoritative allowance and understand which requests are charged. ## OpenAPI Specs - [openapi](https://docs.tempmaillab.com/docs/openapi.yaml)