API Documentation

Base URL: https://ebounce.custmax.com

Authentication

Pass your API key in the X-API-Key header or as ?api_key=. Create keys in your dashboard.

curl -H "X-API-Key: ebk_your_key" \
  "https://ebounce.custmax.com/api/check?email=test@example.com"

GET /api/check — verify one email

Query: email (required). Costs 1 validation.

{"ok":true,"result":{"email":"test@example.com","syntax":true,"mx":true,
 "disposable":false,"role_based":false,"verdict":"pass","reason":"ok"}}

Verdicts: pass / fail. Reasons: ok, bad-syntax, no-mx, disposable, role-based, dns-error.

POST /api/check-batch — verify up to 500

JSON body: {"emails": ["a@x.com", "b@y.com"]}. Costs 1 validation per email.

{"ok":true,"total":2,"pass":1,"results":[...]}

Errors

401 missing/invalid API key · 402 monthly quota exceeded (upgrade at /pricing) · 400 bad request.