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

Ang mga error response ay may messageKey para sa localized na error message.

Authentication

Lahat ng API request ay nangangailangan ng API key na ipinapasa sa pamamagitan ng X-API-Key header. Kunin ang iyong API key mula sa dashboard pagkatapos mag-register.

API Key

Para sa paggawa ng temp email at pagkuha ng verification code. Kailangan ng aktibong bayad na subscription.

X-API-Key: your_64char_hex_key

Session Cookie

Para sa domain, email account, at DNS management endpoint. Naka-set pagkatapos mag-login.

Cookie: evilmail_session=...

Ang Temp Email API ay nangangailangan ng bayad na plan

Ang temp email API at regex extraction endpoint ay nangangailangan ng aktibong subscription.

Pansamantalang Email

Kailangan ng Bayad na Plan

Gumawa ng disposable na email address na may configurable na TTL. Mga magagamit na domain: evilmail.pro, evilmail.cloud.

Create a temporary email address

Request Body

domainstringopsyonalDomain to use (default: evilmail.pro)

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

Response

{
  "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 at Mensahe

Basahin ang mga papasok na email mula sa iyong temp inbox. Kinukuha ang mga mensahe sa pamamagitan ng IMAP.

Domain Management

Magrehistro ng custom na domain, i-verify ang DNS, at pamahalaan ang iyong email infrastructure.

Mga Email Account

Gumawa, mag-lista, at mamahala ng mga email account sa iyong mga na-verify na domain.

Smart Verification Code Extraction

API Key

Automatic na pagkuha ng verification code mula sa papasok na email. Perpekto para sa automated testing at CI/CD.

Extract verification code from the latest email

Mga Parameter

servicestringkinakailanganService name (see supported list)

emailstringkinakailanganEmail address to search (query param)

Response

{
  "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.

Mga Suportadong Serbisyo

Serbisyo	Endpoint	Code Pattern	Mga Sender Domain
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

Kailangan ng Ibang Serbisyo?

Kung ang hinahanap mong serbisyo ay wala sa listahan, ipaalam sa amin.

Makipag-ugnayan sa Amin

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

Buong DNS record management sa pamamagitan ng PowerDNS. Suportado ang A, AAAA, CNAME, MX, TXT, NS, SRV, at CAA record type.

Mga Halimbawa ng Code

Kumpletong mga halimbawa para sa paggawa ng temp email, pagbasa ng inbox, at pagkuha ng verification code.

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": [...] } }

Pagkuha ng Verification Code

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"

Mga Halimbawa ng Domain Management

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"}'

Mga Rate Limit at Plan

Mga Limit ng Plan

Feature	Free	Bronze	Gold	Premium
Custom na Domain	1	5	25	999
Email / Domain	5	999	999	999
Temp Email API	Web lamang	Buong	Buong	Buong
Regex API	Web lamang	Buong	Buong	Buong
API Rate Limit	100/hr	1,000/hr	5,000/hr	Walang limitasyon
Temp Session / IP	10	10	10	10

Mga Endpoint Rate Limit

Bawat IP address

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}Batay sa plan

Error Handling

Lahat ng error response ay may status field na "error", nababasang mensahe, at opsyonal na messageKey.

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

Code	Status	Paglalarawan
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

Mga Naka-localize na Error Message

Gamitin ang messageKey field para ipakita ang mga error sa gustong wika ng user.

API Explorer

Subukan ang mga API endpoint nang direkta mula sa iyong browser. Ilagay ang iyong API key at magpadala ng mga request.

API Explorerv1.0

evilmail.pro

POST

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

API Key

Request Body

domain

ttlMinutes

Magpadala ng request para makita ang response

Handa nang mag-integrate?

Kunin ang iyong API key mula sa dashboard at magsimulang mag-build.

Magsimula nang Libre Tingnan ang mga Plan

{ "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" } }

Serbisyo

Endpoint

Code Pattern

Mga Sender Domain

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 na Domain

999

Email / Domain

999

Temp Email API

Web lamang

Buong

Regex API

Web lamang

Buong

API Rate Limit

100/hr

1,000/hr

5,000/hr

Walang limitasyon

Temp Session / IP

Code

Status

Paglalarawan

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