Developer API Reference

Automate end-to-end signup tests, transactional email checks, and domain MX validation in Playwright, Cypress, or CI pipelines using Email Generator JSON endpoints.

Base URLhttps://generatoremail.com

Admin / Key AuthX-API-Key: ak_...

Public Rate LimitPer-IP Sliding Window

Response Formatapplication/json

GET/api/public/domains

Retrieve the list of active disposable email domains available for public temporary mailbox generation.

Example Response

[
  {
    "name": "bingora.my.id",
    "active": true,
    "tier": "free",
    "source": "default"
  },
  {
    "name": "spotifysub.my.id",
    "active": true,
    "tier": "free",
    "source": "default"
  }
]

GET/api/public/inbox?email=user@domain

Poll incoming messages for an active non-reserved temporary address on an approved platform domain. Reserved administrative local-parts (such as admin@ or support@) are rejected with HTTP 403.

Example cURL

curl -s "https://generatoremail.com/api/public/[email protected]"

GET/api/tools/domain-check?domain=example.com

Public DNS MX and disposable email classification utility. Also available via our interactive Disposable Email Domain Checker.

Example Response

{
  "domain": "10minutemail.com",
  "isDisposable": true,
  "hasMx": true,
  "verdict": "Disposable / Temporary Email Domain",
  "riskScore": 95
}

Attachment & Acceptable Use Policy

To prevent malware distribution, binary attachments are stripped from disposable mailboxes while plain-text and sanitized HTML bodies are returned via JSON. Automated API usage is subject to rate limits and our Terms of Service.