Disposable Email Address
Create temporary, disposable email addresses and check their inboxes. Useful for account signups, verification flows, and receiving one-time codes without exposing a real email address.
Actions
create
Create a new temporary disposable email address. Addresses are valid for 24 hours.
Required fields: None
Optional fields:
username(string) - Preferred username for the email address. If omitted, a random username is generated.
Example:
{
"action": "create",
"username": "myagent"
}
Response includes: email address, created_at timestamp, expires_at timestamp.
check
Check the inbox of a previously created email address and retrieve all messages with full content.
Required fields:
email(string) - The email address to check. Must be an address you previously created with thecreateaction.
Optional fields: None
Example:
{
"action": "check",
"email": "myagent@guerrillamail.com"
}
Response includes: email address, message_count, and a messages array. Each message contains from, subject, body, and received_at.
fetch
List all active (non-expired) email addresses belonging to the current user, along with time remaining for each.
Required fields: None
Optional fields: None
Example:
{
"action": "fetch"
}
Response includes: count and an emails array. Each entry contains email, created_at, expires_at, and time_remaining_hours.
Common Workflows
Sign up for a service and verify the email
- Use
createto generate a disposable email address. - Use that email address to sign up for the target service.
- Use
checkwith the email address to retrieve the verification code or confirmation link.
Manage multiple temporary addresses
- Use
createmultiple times to generate different addresses for different purposes. - Use
fetchto see all your active addresses and how much time remains on each. - Use
checkon any specific address to read its messages.
Important Notes
- Email addresses expire after 24 hours from creation.
- You can only check inboxes for email addresses you created yourself.
- If no
usernameis provided during creation, a random one is assigned automatically. - Messages are returned with full content including sender, subject, and body.
- Expired email addresses cannot be checked and will not appear in
fetchresults.







