REST API

Base URL: https://api.verifier.example.com

Authentication

Pass your API key as a bearer token. API keys start with vk_and are created in the API Keys page.

Authorization: Bearer vk_...

Verify a single email

POST /v1/verify
Content-Type: application/json

{ "email": "user@example.com" }

Response:

{
  "email": "user@example.com",
  "verdict": "valid",
  "score": 95,
  "reasons": ["smtp:accepted", "catchall:False"],
  "is_catchall": false,
  "is_disposable": false,
  "is_role": false,
  "is_free_mail": false,
  "mx_provider": "google",
  "deep_score": null,
  "checked_at": "2026-05-27T12:00:00Z"
}

Bulk verify

POST /v1/verify/bulk
Content-Type: multipart/form-data

file=@emails.csv

Returns a job_id. Poll GET /v1/jobs/{job_id}for status and GET /v1/jobs/{job_id}/results for verdicts.

Verdicts

• valid — mailbox confirmed real.
• invalid — hard bounce, disposable, or no MX.
• risky — catch-all domain with mid-confidence deep score.
• unknown — SMTP timeout / temp fail / inconclusive.