Developer

API Documentation

Integrate EvilMail into your applications

Authentication

All API requests require an API key passed via the X-API-Key header. Get your API key from the dashboard after registration.

X-API-Key: your_api_key_here

Get Your API Key

Endpoints

POST/api/temp-emailCreate a temporary email

Request Body

{ "domain": "evilmail.pro", "ttlMinutes": 60 }

Response

{ "status": "success", "data": { "email": "[email protected]", "sessionToken": "...", "expiresAt": "..." } }

GET/api/temp-emailGet current temp session

Response

{ "status": "success", "data": { "email": "...", "ttlMinutes": 60, "expiresAt": "..." } }

DELETE/api/temp-emailDelete temp session

Response

{ "status": "success" }

GET/api/inboxGet inbox messages

Response

{ "status": "success", "data": [{ "uid": 1, "from": "...", "subject": "...", "date": "...", "seen": false }] }

GET/api/message/:uidGet full message by UID

Response

{ "status": "success", "data": { "uid": 1, "html": "...", "text": "..." } }

GET/api/domainsList your domains

Response

{ "status": "success", "data": [{ "domain": "...", "isVerified": true }] }

POST/api/domainsAdd a domain

Request Body

{ "domain": "example.com" }

Response

{ "status": "success" }

DELETE/api/domainsRemove a domain

Request Body

{ "domain": "example.com" }

Response

{ "status": "success" }

POST/api/accountsCreate email account

Request Body

{ "email": "[email protected]", "password": "..." }

Response

{ "status": "success" }

GET/api/accountsList email accounts

Response

{ "status": "success", "data": [...] }

DELETE/api/accountsDelete email accounts

Request Body

{ "emails": ["[email protected]"] }

Response

{ "status": "success" }

Code Examples

# 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_here" \
  -d '{"domain": "evilmail.pro", "ttlMinutes": 60}'

# Check inbox
curl https://evilmail.pro/api/inbox \
  -H "X-API-Key: your_api_key_here"

# Read a message
curl https://evilmail.pro/api/message/1 \
  -H "X-API-Key: your_api_key_here"

Rate Limiting

API requests are rate-limited based on your plan. Free: 100/hour, Pro: 1000/hour, Enterprise: unlimited.

Free

100/hour

Pro

1,000/hour

Enterprise

Unlimited