Developers

API documentation

Send your key as an X-API-Key header on every request. Free plan: 100 checks a day.

Verify one address

POST /api/v1/verify
X-API-Key: your_key
Content-Type: application/json

{"email": "someone@company.com"}

→ {"email":"...", "status":"valid", "checked_by":"microsoft",
     "quota_remaining":99}

Find an address

POST /api/v1/find
X-API-Key: your_key

{"name": "John Smith", "domain": "company.com"}

→ {"email":"john.smith@company.com", "status":"found"}

Verify a list

POST /api/v1/bulk
X-API-Key: your_key

{"emails": ["a@x.com", "b@y.com"]}      // up to 1000 per call

→ {"count":2, "resolved":1, "results":[ ... ]}

Check your usage

GET /api/v1/usage
X-API-Key: your_key

→ {"plan":"free","used_today":3,"daily_quota":100,"remaining":97}

Statuses

valid Confirmed real.

invalid Confirmed undeliverable.

catch all Domain accepts everything.

unknown Could not be proven.

Errors: 401 bad key · 429 quota exhausted · 413 batch too large.