v1.0 Public REST API
Temporary Disposable Email API
Automate software testing, continuous integration, and QA verification flows with fast, free disposable email endpoints.
⚡ Sub-Second Speed
Built on Cloudflare Edge global network. Incoming verification emails and OTPs arrive in sub-seconds with low latency worldwide.
🔒 Zero API Keys Required
Start testing immediately without tedious developer account approvals, credit cards, or rate-limited API key hurdles.
🤖 Test Automation Ready
Drop-in compatibility with Playwright, Cypress, Selenium, Jest, Python pytest, and CI/CD automated test suites.
1. Create Mailbox Endpoint
Generate a random disposable email address or request a custom username under our active domain pool.
POST https://temp-mail.im/api/create-mailbox
2. Fetch Inbox Messages
Query all received messages, verification codes, and OTPs for a specific temporary mailbox.
GET https://temp-mail.im/api/[email protected]
3. Code Integration Example (cURL & Node.js)
// Node.js / Fetch API Example
const res = await fetch('https://temp-mail.im/api/[email protected]');
const data = await res.json();
console.log('Received OTPs:', data.messages);