API Reference

Base URL

https://mailmorph.com

All API requests should be made to this base URL.

Authentication

All API endpoints require authentication using an API key. Include your API key in the request headers:

x-api-key: YOUR_API_KEY

Rate Limiting

The API is rate-limited to 500 requests per minute per API key. Monitor the rate limit headers in responses to avoid hitting limits.

Rate Limit Headers

X-RateLimit-Limit

The maximum number of requests allowed per minute

X-RateLimit-Remaining

The number of requests remaining in the current time window

X-RateLimit-Reset

The time in milliseconds when the rate limit will reset

Endpoints

Validate Email

POST/validate

Request Body

{
  "email": "test@example.com"  // Required
}

Response

{
  "email": "test@example.com",
  "is_temp": false,
  "remaining_credits": 99
}

Error Responses

400Invalid email format or missing required fields

401Invalid or missing API key

402Insufficient credits

429Rate limit exceeded

500Internal server error

Example Request

curl -X POST https://mailmorph.com/api/validate \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "test@example.com"}'

Getting Started

Ready to start using our API? Sign up for an account to get your API key and free credits.