REST API

API Documentation

Base URL /api/v1. Authenticate with a bearer JWT or an X-API-Key header.

Verify a single email

curl -X POST https://your-domain/api/v1/verify/ \
  -H "X-API-Key: <your-key>" \
  -H "Content-Type: application/json" \
  -d '{"email":"test@mail.tm"}'

Response

{
  "email": "test@mail.tm",
  "domain": "mail.tm",
  "disposable": true,
  "provider": "mail.tm",
  "source": "database",
  "confidence": 100
}

Bulk verification

curl -X POST https://your-domain/api/v1/verify/bulk/ \
  -H "X-API-Key: <your-key>" \
  -H "Content-Type: application/json" \
  -d '{"emails":["a@mail.tm","b@gmail.com"]}'

Authentication

Create an account, then generate an API key from your dashboard. For dashboard access, obtain a JWT via POST /api/v1/auth/login/.

The source field