Email verification API docs
Verify email address quality with a technical status, recommended action, and the signals behind the result. Authenticated verification consumes one project credit.
Create an account and project, then send its key in the X-API-Key header or as Authorization: Bearer YOUR_API_KEY. Keep the key on your server.
Base URL: https://emailverifier.dev
Verify one email address
POST /api/v1/verify
Send only an email address. With a project API key, one successful call consumes one project credit. Without a key, the public demo allows 10 requests per hour. Project IDs are resolved from API keys and are never accepted from clients.
HTTP responses
- 200
- Verification result
- 400
- Invalid request body or email field
- 401
- Invalid API key
- 402
- Project has no credits remaining
- 429
- Rate limit exceeded
Classify one email domain
GET /api/v1/domains/{domain}
Returns the provider classification, risk level, and whether the domain appears able to receive email. Every authenticated domain check consumes one project credit, regardless of classification. Without a key, the public demo allows 10 requests per hour. It does not confirm a specific mailbox or message delivery.
HTTP responses
- 200
- Domain classification
- 401
- Invalid API key
- 402
- Project has no credits remaining
- 404
- Invalid domain path
- 429
- Rate limit exceeded
Get API usage and remaining credits
GET /api/v1/usage
Returns lifetime completed checks and the current credit balance for the project associated with the API key. This request does not use a credit.
HTTP responses
- 200
- Project usage
- 401
- API key required or invalid
- 429
- Rate limit exceeded
Loading API reference…