{
  "status": "success" | "error",
  "message": "Human-readable message (optional)",
  "messageKey": "i18n key for localized errors (optional)",
  "data": { ... }
}

Error responses wɔ messageKey ama localized error messages.

Authentication

API abisadeɛ nyinaa hia API key a wɔde bɛfa X-API-Key header mu. Nya wo API key firi dashboard no mu bere a wokyerɛw din wieɛ.

API Key

Ɛma temp email yɛ ne verification codes a woyi. Ɛhia paid subscription a ɛyɛ adwuma.

X-API-Key: your_64char_hex_key

Session Cookie

Ɛma domain, email account, ne DNS management endpoints. Wɔde si hɔ login akyi.

Cookie: evilmail_session=...

Temp Email API hia paid plan

Temp email API ne regex extraction endpoints hia subscription a ɛyɛ adwuma.

Temp Email

Ɛhia Paid Plan

Yɛ disposable email addresses a wɔ configurable TTL. Domains a ɛwɔ hɔ: evilmail.pro, evilmail.cloud.

Create a temporary email address

Abisadeɛ Mu Nsɛm

domainstringoptionalDomain to use (default: evilmail.pro)

ttlMinutesnumberoptionalLifetime: 10, 30, 60, 360, 1440 (default: 60)

Mmuaeɛ

{
  "status": "success",
  "data": {
    "email": "[email protected]",
    "domain": "evilmail.pro",
    "sessionToken": "a1b2c3d4...",
    "ttlMinutes": 60,
    "expiresAt": "2026-03-07T15:30:00.000Z"
  }
}

Available domains: evilmail.pro, evilmail.cloud. Requires an active paid subscription.

Inbox ne Nsɛm

Kenkan emails a ɛreba wo temp inbox mu. Wɔfa nsɛm no firi IMAP so.

Domain Management

Kyerɛw custom domains, verify DNS, na hwɛ wo email infrastructure so.

Email Accounts

Yɛ, list, na hwɛ email accounts so wɔ wo domains a w'atim ase.

Smart Verification Code Extraction

API Key

Yi verification codes firi emails a ɛreba mu automatic. Eye ma automated testing ne CI/CD.

Extract verification code from the latest email

Parameters

servicestringɛhiaService name (see supported list)

emailstringɛhiaEmail address to search (query param)

Mmuaeɛ

{
  "status": "success",
  "data": {
    "code": "847291",
    "service": "google",
    "email": "[email protected]",
    "from": "[email protected]",
    "subject": "Your verification code",
    "date": "2026-03-07T14:22:00.000Z"
  }
}

Searches the last 20 messages. You must own the domain.

Services a Yɛboa

Service	Endpoint	Code Pattern	Sender Domains
Google	/api/regex/google	G-XXXXXX	google.com, accounts.google.com
Facebook	/api/regex/facebook	XXXXXX	facebookmail.com, facebook.com
Twitter/X	/api/regex/twitter	XXXXXXXX	twitter.com, x.com
Instagram	/api/regex/instagram	XXXXXX	instagram.com, mail.instagram.com
TikTok	/api/regex/tiktok	XXXX-XXXXXX	tiktok.com
Discord	/api/regex/discord	XXXXXX	discord.com
LinkedIn	/api/regex/linkedin	XXXXXX	linkedin.com
iCloud	/api/regex/icloud	XXXXXX	apple.com, id.apple.com

Wohia Service Foforɔ?

Sɛ service a wohwehwɛ no nni list no so a, ka kyerɛ yɛn.

Di yɛn ho nkitaho

api-example

# Extract Google verification code
curl "https://evilmail.pro/api/regex/[email protected]" \
  -H "X-API-Key: YOUR_API_KEY"

# Extract Discord verification code
curl "https://evilmail.pro/api/regex/[email protected]" \
  -H "X-API-Key: YOUR_API_KEY"

# Extract TikTok code
curl "https://evilmail.pro/api/regex/[email protected]" \
  -H "X-API-Key: YOUR_API_KEY"

DNS Management

DNS record management a edi mu nyinaa wɔ PowerDNS so. Ɛboa A, AAAA, CNAME, MX, TXT, NS, SRV, ne CAA.

Code Nhwɛsoɔ

Nsɛm a edi mu nyinaa ama temp email yɛ, inbox akenkan, ne verification code a woyi.

Temp Email Flow

api-example

# Create a temporary email
curl -X POST https://evilmail.pro/api/temp-email \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"domain": "evilmail.pro", "ttlMinutes": 60}'

# Response: { "data": { "email": "...", "sessionToken": "abc123..." } }

# Poll for incoming messages using the session token
curl https://evilmail.pro/api/temp-email/abc123...

# Response includes messages array
# { "data": { "email": "...", "messages": [...] } }

Verification Code a Woyi

api-example

# Extract Google verification code
curl "https://evilmail.pro/api/regex/[email protected]" \
  -H "X-API-Key: YOUR_API_KEY"

# Extract Discord verification code
curl "https://evilmail.pro/api/regex/[email protected]" \
  -H "X-API-Key: YOUR_API_KEY"

# Extract TikTok code
curl "https://evilmail.pro/api/regex/[email protected]" \
  -H "X-API-Key: YOUR_API_KEY"

Domain Management Nhwɛso

api-example

# Add a domain
curl -X POST https://evilmail.pro/api/domains \
  -H "Content-Type: application/json" \
  -H "Cookie: evilmail_session=YOUR_SESSION" \
  -d '{"domain": "mydomain.com"}'

# List domains
curl https://evilmail.pro/api/domains \
  -H "Cookie: evilmail_session=YOUR_SESSION"

# Verify DNS
curl -X POST https://evilmail.pro/api/domains/check \
  -H "Content-Type: application/json" \
  -H "Cookie: evilmail_session=YOUR_SESSION" \
  -d '{"domain": "mydomain.com"}'

# Create email account
curl -X POST https://evilmail.pro/api/accounts \
  -H "Content-Type: application/json" \
  -H "Cookie: evilmail_session=YOUR_SESSION" \
  -d '{"email": "[email protected]", "password": "secure123"}'

Rate Limits ne Plans

Plan Limits

Feature	Free	Bronze	Gold	Premium
Custom Domains	1	5	25	999
Emails / Domain	5	999	999	999
Temp Email API	Web nkutoo	Nyinaa	Nyinaa	Nyinaa
Regex API	Web nkutoo	Nyinaa	Nyinaa	Nyinaa
API Rate Limit	100/hr	1,000/hr	5,000/hr	Ɛnni limit
Temp Sessions / IP	10	10	10	10

Endpoint Rate Limits

IP address biara

POST /api/auth/login10 / 15 min

POST /api/auth/register5 / 1 hour

POST /api/auth/forgot-password3 / 1 hour

POST /api/auth/reset-password5 / 15 min

PUT /api/account/password5 / 15 min

POST /api/contact5 / 1 hour

POST /api/temp-email10 sessions / IP

GET /api/regex/{service}Plan-based

Mfomsoɔ Hwɛ

Error responses nyinaa wɔ status field, message a wobetumi akenkan, ne messageKey a ɛyɛ optional.

{
  "status": "error",
  "message": "Domain limit reached. Upgrade your plan for more.",
  "messageKey": "domainLimitReached"
}

Code	Status	Nsɛm
200	Success	Request completed successfully
400	Bad Request	Missing or invalid parameters
401	Unauthorized	Invalid or missing authentication
403	Forbidden	Insufficient permissions or plan limits
404	Not Found	Resource does not exist
409	Conflict	Resource already exists (duplicate)
429	Rate Limited	Too many requests, slow down
500	Server Error	Internal server error

Localized Error Messages

Fa messageKey field di dwuma de kyerɛ errors wɔ user kasa mu.

API Hwehwɛfo

Sɔ hwɛ API endpoints firi wo browser mu. Hyɛ wo API key na mena requests.

API Hwehwɛfov1.0

evilmail.pro

POST

POSThttps://evilmail.pro/api/temp-email

API Key

Abisadeɛ Mu Nsɛm

domain

ttlMinutes

Mena request na woahu response

Woasiesie ama integration?

Nya wo API key firi dashboard na fi ase yɛ.

Fi ase kwa Hwɛ Plans

{ "status": "success", "data": { "email": "[email protected]", "domain": "evilmail.pro", "sessionToken": "a1b2c3d4...", "ttlMinutes": 60, "expiresAt": "2026-03-07T15:30:00.000Z" } }

{ "status": "success", "data": { "code": "847291", "service": "google", "email": "[email protected]", "from": "[email protected]", "subject": "Your verification code", "date": "2026-03-07T14:22:00.000Z" } }

Service

Endpoint

Code Pattern

Sender Domains

Google

/api/regex/google

G-XXXXXX

google.com, accounts.google.com

Facebook

/api/regex/facebook

XXXXXX

facebookmail.com, facebook.com

Twitter/X

/api/regex/twitter

XXXXXXXX

twitter.com, x.com

Instagram

/api/regex/instagram

XXXXXX

instagram.com, mail.instagram.com

TikTok

/api/regex/tiktok

XXXX-XXXXXX

tiktok.com

Discord

/api/regex/discord

XXXXXX

discord.com

/api/regex/linkedin

XXXXXX

linkedin.com

iCloud

/api/regex/icloud

XXXXXX

apple.com, id.apple.com

# Extract Google verification code curl "https://evilmail.pro/api/regex/[email protected]" \ -H "X-API-Key: YOUR_API_KEY" # Extract Discord verification code curl "https://evilmail.pro/api/regex/[email protected]" \ -H "X-API-Key: YOUR_API_KEY" # Extract TikTok code curl "https://evilmail.pro/api/regex/[email protected]" \ -H "X-API-Key: YOUR_API_KEY"

# Create a temporary email curl -X POST https://evilmail.pro/api/temp-email \ -H "Content-Type: application/json" \ -H "X-API-Key: YOUR_API_KEY" \ -d '{"domain": "evilmail.pro", "ttlMinutes": 60}' # Response: { "data": { "email": "...", "sessionToken": "abc123..." } } # Poll for incoming messages using the session token curl https://evilmail.pro/api/temp-email/abc123... # Response includes messages array # { "data": { "email": "...", "messages": [...] } }

# Add a domain curl -X POST https://evilmail.pro/api/domains \ -H "Content-Type: application/json" \ -H "Cookie: evilmail_session=YOUR_SESSION" \ -d '{"domain": "mydomain.com"}' # List domains curl https://evilmail.pro/api/domains \ -H "Cookie: evilmail_session=YOUR_SESSION" # Verify DNS curl -X POST https://evilmail.pro/api/domains/check \ -H "Content-Type: application/json" \ -H "Cookie: evilmail_session=YOUR_SESSION" \ -d '{"domain": "mydomain.com"}' # Create email account curl -X POST https://evilmail.pro/api/accounts \ -H "Content-Type: application/json" \ -H "Cookie: evilmail_session=YOUR_SESSION" \ -d '{"email": "[email protected]", "password": "secure123"}'

Feature

Free

Bronze

Gold

Premium

Custom Domains

999

Emails / Domain

999

Temp Email API

Web nkutoo

Nyinaa

Regex API

Web nkutoo

Nyinaa

API Rate Limit

100/hr

1,000/hr

5,000/hr

Ɛnni limit

Temp Sessions / IP

Code

Status

Nsɛm

200

Success

Request completed successfully

400

Bad Request

Missing or invalid parameters

401

Unauthorized

Invalid or missing authentication

403

Forbidden

Insufficient permissions or plan limits

404

Not Found

Resource does not exist

409

Conflict

Resource already exists (duplicate)

429

Rate Limited

Too many requests, slow down

500

Server Error

Internal server error