Guerrilla Mail

About Guerrilla Mail

Guerrilla Mail provides a JSON API, accessed over HTTP at api.guerrillamail.com/ajax.php, for generating and managing disposable email addresses. Each request specifies a function name along with the end user's IP address and user agent, and the API uses PHPSESSID cookies to maintain session state and an optional SUBSCR cookie for subscriber addresses; responses are returned as JSON.

The API supports functions to initialize a session and obtain a random email address (get_email_address), change the active address to a specific username (set_email_user), poll for new incoming messages (check_email), fetch a specific email's contents (fetch_email), and manage the session lifecycle, including forgetting the current address (forget_me) and extending its active time (extend). Addresses are temporary, expiring after 60 minutes of inactivity by default, with sessions timing out after about 18 minutes of inactivity; changing back to a previously used address restores its still-valid messages.

The service is aimed at developers building applications that need temporary or disposable inboxes, such as clients for receiving verification emails or testing mail flows without a permanent address. The API is described as public, open to all, and free to use, though rate limits are enforced without published thresholds.

Key features

• Provides a public JSON API over HTTP for disposable email addresses
• Generates a temporary email address via get_email_address
• Allows switching to a custom email username via set_email_user
• Checks for new incoming email via check_email
• Fetches and displays full email content via fetch_email
• Supports extending or forgetting the current email address via extend and forget_me

Frequently asked questions