Guerrilla Mail API

⭐ Beginner's Pick Email / No Auth Required Beginner HTTPS
Free to Use Varies (check documentation)

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

email delivery status
message ID
bounce/complaint data
open/click tracking

Example Response

JSON 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

No messages appear even after sending a test email The Guerrilla Mail address is session-based; if you did not preserve the sid_token from the first response, you may be checking a different inbox
Save the sid_token returned by get_email_address and pass it in all subsequent requests to check the same inbox
Messages appear truncated or without full body The email_list endpoint returns summaries; full body requires a separate fetch_email call
Use the fetch_email action with the specific mail_id from the list response to retrieve the complete message content
JSONP callback errors in browser Guerrilla Mail uses a JSONP-style API that requires a callback parameter for browser requests
For server-side code, use the standard JSON endpoint; for browser use, include &callback=myFunction or use a server-side proxy

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 15/20
🔒 Security 15/15
🛠 Developer XP 15/20
✓ Reliability 7/15
Response Time 284ms

Fully tested on Apr 5, 2026

Technical Specifications

Auth No Auth
HTTPS REQUIRED
CORS UNKNOWN
Category Email
Difficulty Beginner
Verified: 2026-04-04

Alternatives to Guerrilla Mail

Technical alternatives for different use cases.

Temporary email with GraphQL API

Better For

Modern GraphQL-based temporary email integration

Trade-off

Long-lived temporary addresses

Temporary email with REST API and custom domain support

Better For

Disposable email with API-first design

Trade-off

Email address longevity and reliability

Similar APIs

View All →