Ontwikkelaarsdocumentatie

EvilMail API-referentie

Integreer wegwerp-e-mail, aangepaste domeinen, inbox-lezen, DNS-beheer en slimme verificatiecode-extractie in uw applicaties.

Basis-URL:https://evilmail.pro

Formaat:JSON

Authenticatie:API-sleutel / Sessie

Protocollen:Alleen HTTPS

Overzicht

De EvilMail API biedt programmatische toegang tot alle platformfuncties. Maak wegwerp-e-mails aan, beheer aangepaste domeinen, lees inboxen, extraheer verificatiecodes en beheer DNS-records — alles via een eenvoudige RESTful interface.

Tijdelijke e-mail API

Wegwerp-inboxen aanmaken, berichten lezen, automatisch verlopen

Domein- en e-mail-API

Aangepaste domeinen, e-mailaccounts, DNS-beheer

Regex-extractie

Automatische extractie van verificatiecodes van 8+ diensten

Responsformaat

Alle responses volgen een consistente JSON-structuur:

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

Foutresponses bevatten een messageKey voor gelokaliseerde foutmeldingen die overeenkomen met de taal van het gebruikersaccount.

Authenticatie

EvilMail gebruikt twee authenticatiemethoden afhankelijk van het type endpoint. Alle API-verzoeken moeten via HTTPS worden gedaan.

API-sleutel

Voor het aanmaken van tijdelijke e-mails en verificatiecode-extractie. Vereist een actief betaald abonnement.

X-API-Key: your_64char_hex_key

Sessiecookie

Voor domein-, e-mailaccount- en DNS-beheer-endpoints. Ingesteld na inloggen.

Cookie: evilmail_session=...

Tijdelijke e-mail API vereist een betaald abonnement

De tijdelijke e-mail API en regex-extractie-endpoints vereisen een actief Bronze-, Gold- of Premium-abonnement. Gratis accounts kunnen alleen de webinterface gebruiken.

Tijdelijke e-mail

Betaald abonnement vereist

Maak tijdelijke e-mailadressen aan met configureerbare TTL. Beschikbare domeinen: evilmail.pro, evilmail.cloud.

Create a temporary email address

Request body

domainstringoptioneelDomain to use (default: evilmail.pro)

ttlMinutesnumberoptioneelLifetime: 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 en berichten

Lees inkomende e-mails uit uw tijdelijke inbox. Berichten worden via IMAP opgehaald en in realtime geretourneerd.

Domeinbeheer

Registreer aangepaste domeinen, verifieer DNS en beheer uw e-mailinfrastructuur. Domeinlimieten zijn afhankelijk van uw abonnement.

E-mailaccounts

Maak e-mailaccounts aan, bekijk en beheer ze onder uw geverifieerde domeinen. Ondersteunt individuele en bulkcreatie met willekeurige gebruikersnaamgeneratie.

Slimme verificatiecode-extractie

API-sleutel

Extraheer automatisch verificatiecodes uit inkomende e-mails. Perfect voor geautomatiseerd testen, registratieflows en CI/CD-pipelines.

Extract verification code from the latest email

Parameters

servicestringvereistService name (see supported list)

emailstringvereistEmail 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.

Ondersteunde diensten

Dienst	Endpoint	Codepatroon	Afzenderdomeinen
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

Andere dienst nodig?

Als de dienst die u zoekt hierboven niet wordt vermeld, laat het ons weten. We breiden regelmatig onze ondersteunde integraties uit op basis van feedback van ontwikkelaars en kunnen nieuwe regex-patronen toevoegen voor elke op e-mail gebaseerde verificatiedienst.

Neem contact op

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-beheer

Volledig DNS-recordbeheer via PowerDNS. Ondersteunt A-, AAAA-, CNAME-, MX-, TXT-, NS-, SRV- en CAA-recordtypen. Records propageren via 4 geografisch verspreide nameservers.

Codevoorbeelden

Complete werkende voorbeelden voor het aanmaken van tijdelijke e-mails, het lezen van inboxen en het extraheren van verificatiecodes.

Tijdelijke e-mailflow

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

Verificatiecode-extractie

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"

Domeinbeheervoorbeelden

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

Snelheidslimieten en abonnementen

Abonnementslimieten

Functie	Free	Bronze	Gold	Premium
Aangepaste domeinen	1	5	25	999
E-mails / domein	5	999	999	999
Tijdelijke e-mail API	Alleen web	Volledig	Volledig	Volledig
Regex API	Alleen web	Volledig	Volledig	Volledig
API-snelheidslimiet	100/hr	1,000/hr	5,000/hr	Onbeperkt
Tijdelijke sessies / IP	10	10	10	10

Endpoint-snelheidslimieten

Per IP-adres

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}Abonnementsgebaseerd

Foutafhandeling

Alle foutresponses bevatten een statusveld ingesteld op "error", een leesbaar bericht en een optionele messageKey voor gelokaliseerde foutmeldingen die overeenkomen met de taal van het gebruikersaccount.

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

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

Gelokaliseerde foutmeldingen

Gebruik het messageKey-veld om fouten weer te geven in de voorkeurstaal van de gebruiker. Ondersteund: Engels, Turks, Russisch, Oekraïens, Pools, Frans, Duits, Azerbeidzjaans, Perzisch, Filipijns, Hausa, Akan.

API Explorer

Test API-endpoints rechtstreeks vanuit uw browser. Voer uw API-sleutel in en verstuur verzoeken om live responses te bekijken.

API Explorerv1.0

evilmail.pro

POST

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

API-sleutel

Request body

domain

ttlMinutes

Verstuur een verzoek om de response te bekijken

Klaar om te integreren?

Haal uw API-sleutel op uit het dashboard en begin met bouwen. Volledige toegang bij elk betaald abonnement.

Gratis beginnen Abonnementen bekijken

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

Dienst

Endpoint

Codepatroon

Afzenderdomeinen

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

Functie

Free

Bronze

Gold

Premium

Aangepaste domeinen

999

E-mails / domein

999

Tijdelijke e-mail API

Alleen web

Volledig

Regex API

Alleen web

Volledig

API-snelheidslimiet

100/hr

1,000/hr

5,000/hr

Onbeperkt

Tijdelijke sessies / IP

Code

Status

Beschrijving

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