Guerrilla Mail API
Overview
Guerrilla Mail provides a REST API for creating and reading disposable temporary email addresses, useful for testing email flows without exposing real inboxes. You can fetch a randomly generated address, check for incoming messages, and read message bodies — all without authentication. Addresses are ephemeral and messages are automatically deleted after a short period.
Beginner Tip
Guerrilla Mail requires no API key and no sign-up — just make a GET request and you instantly have a working throwaway inbox. It is perfect for testing registration flows, email confirmations, and any workflow that sends automated emails during development.
Available Data
Example Response
{
"message_id": "msg_abc123def456",
"status": "delivered",
"to": "[email protected]",
"subject": "Welcome!",
"timestamp": "2025-01-15T10:30:00Z"
} Field Reference
email_addr The generated disposable email address for this session email_timestamp Unix timestamp when this temporary address was created sid_token Session token that identifies this inbox — must be passed in all subsequent requests to access messages mail_id Unique identifier for a received message, used to fetch the full email body mail_subject Subject line of a received email message mail_expt Sender address of the received email Implementation Example
const url = "https://www.guerrillamail.com/";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data); What Can You Build?
Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.
Common Errors & Troubleshooting
Matrix Score Breakdown
Fully tested on Apr 5, 2026
Technical Specifications
Related Tags
Alternatives to Guerrilla Mail
Technical alternatives for different use cases.
Temporary email with GraphQL API
Modern GraphQL-based temporary email integration
Long-lived temporary addresses
Temporary email with REST API and custom domain support
Disposable email with API-first design
Email address longevity and reliability
Similar APIs
View All →Disify
⭐ Beginner's PickDisify is a free, no-auth API that checks whether an email address or domain belongs to a known disposable or temporary email service.
DropMail
⭐ Beginner's PickDropMail provides a GraphQL API for creating and managing temporary email inboxes, letting you generate disposable addresses and receive real emails without registration.
EVA
EVA provides programmatic access to validate email addresses via REST API.
Kickbox
⭐ Beginner's PickKickbox provides a free, no-auth email verification endpoint that checks whether an email address is deliverable by performing syntax validation, domain MX lookup, and disposable address detection.
mail.gw
mail.gw is a REST API for creating and managing temporary 10-minute email addresses with full inbox access, all without authentication for basic use.