Temporary Email API: Developer Guide

Create disposable email addresses and read their messages from your code or test suite with the free stopmailing.net REST API.

Overview

StopMailing provides a free REST API for temporary email addresses. No authentication is required. All endpoints accept and return JSON.

Rate Limits

Requests made with an API key are rate-limited per key. When you exceed the limit, the API returns a 429 Too Many Requests response; wait and retry later.

Common Workflows

Generate a new email

Create a fresh temporary email address with a 10-minute TTL.

curl -X POST https://stopmailing.net/api/emails

Get email status

Check the status and remaining TTL of an email address.

curl https://stopmailing.net/api/emails/:address

List messages

Retrieve all messages received at an email address.

curl https://stopmailing.net/api/emails/:address/messages

Real-time updates

Subscribe to Server-Sent Events (SSE) to receive messages as they arrive.

curl -N https://stopmailing.net/api/emails/:address/events

Extend TTL

Extend the lifetime of an email address before it expires.

curl -X PATCH https://stopmailing.net/api/emails/:address

List domains

Get the list of available email domains.

curl https://stopmailing.net/api/domains

Delete email

Delete an email address and all its messages.

curl -X DELETE https://stopmailing.net/api/emails/:address

Testing sign-up flows and agents

Playwright and Cypress quick starts, and the MCP server for AI agents, are on Test inboxes for end-to-end tests and agents.

Interactive API Documentation

Explore and test all endpoints interactively using our Swagger UI.