Guerrilla Mail API

Base URL

https://api.guerrillamail.com/ajax.php

Authentication

No API key. A session token returned by the first call must be passed on subsequent requests.

Rate limit

No published hard limit; the service asks for reasonable use.

Pricing

Free.

CORS

Enabled — callable directly from browser JavaScript

Official docs

Read the docs

Every request below was executed against the live API on 20 Aug 2026, and the response shown is the real body it returned — not an illustration.

curl 'https://api.guerrillamail.com/ajax.php?f=get_email_address'

const res = await fetch("https://api.guerrillamail.com/ajax.php?f=get_email_address");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

import requests

res = requests.get("https://api.guerrillamail.com/ajax.php?f=get_email_address", timeout=20)
res.raise_for_status()
print(res.json())

{
  "email_addr": "vpptfbui@guerrillamailblock.com",
  "email_timestamp": 1787173878,
  "alias": "yaxcu0+1z5tpwk9yph5k",
  "sid_token": "p186qtpq43v8kdqcsapcma449b"
}

email_addrstring

The generated temporary address.

email_timestampinteger

When the address was created.

aliasstring

Internal alias for the address.

sid_tokenstring

Session token — required on every subsequent request.

(check_email) listarray

Messages in the inbox with sender, subject and excerpt.

• Automate end-to-end tests of signup verification emails
• Test password reset flows in CI
• Verify that transactional emails render correctly
• Create throwaway addresses for QA environments

If Guerrilla Mail does not fit, these email apis cover similar ground. Every one was called before publishing, and each links to its own reference page with a working curl command and the response it returned.