getrandom.emailAPI Documentation
Integrate getrandom.email into your workflow with our REST API. Requires a Pro subscription.
The API does not change how much mail you may receive: your subscription includes an allowance, and mail past it is refused as it arrives rather than queued — the sender gets a bounce and nothing appears here later. The pricing page states the allowance and what a top-up adds.
Full API reference
Every endpoint, every field and every response, generated from the code itself. Try them in your browser.
Generating a client? Use https://getrandom.email/api/v1/pro/openapi.json — the same schema, narrowed to the endpoints your API key can call, so everything in it is something you can do. The complete description of the service, including everything that needs a browser session, is at /api/v1/openapi.json.
Using a coding agent?
Our MCP server gives it a disposable address, waits for the mail and reads it — the same key, no code of your own.
Getting started
Create an API key from your dashboard. It is shown once, when you create it, and never again.
Every Pro endpoint is authenticated with the same header, and every path below is relative to https://getrandom.email/api/v1.
curl https://getrandom.email/api/v1/pro/mailboxes/ \
-H "X-API-Key: your-api-key-here"The API reference lists every endpoint with its parameters and its exact response, and lets you call each one with your own key.