TempMail.mobi API

Powerful, simple, and free REST API for developers to automate email testing and verification workflows.

Authentication Required: All API requests must include your unique X-API-KEY header. You can generate your API Key from the User Dashboard.

Endpoints

GET

Generate Random Email (System Domain)

Creates a new random disposable email address using our system domains.

https://tempmail.mobi/api/v1/generate-email
Header: X-API-KEY: Your Api Key
Response Example: 
{
    "status": "success",
    "email": "[email protected]",
    "expires_at": "2026-02-15 14:30:00"
}
GET

Fetch Messages

Fetches all received emails for a specific address. Works for both System Domains and your Active Custom Domains.

https://tempmail.mobi/api/v1/messages?email={email_address}
Header: X-API-KEY: Your Api Key
Response Example: 
{
    "status": "success",
    "messages": [
        {
            "id": "msg_99210",
            "from": "[email protected]",
            "subject": "Your verification code",
            "body": "Your code is 459921",
            "received_at": "1 minute ago"
        }
    ]
}

Rate Limits & Restrictions

  • Standard Rate Limit: 100 requests / minute per IP.
  • Email addresses are valid for 2 hours by default.
  • We block emails from certain financial institutions to prevent abuse.
  • Do not use this API for spamming; your key will be permanently banned.

Need higher limits or custom features?

Contact Enterprise Support →