Verification Endpoints

API endpoints for email verification. All require authentication and an active license.

POST /v1/verify

Verify a single email address.

{"email": "user@example.com", "level": 2}

See Single Verify for full documentation.

POST /v1/bulk

Submit a bulk verification job (up to 100k emails).

{
  "emails": ["user1@example.com", "user2@test.com"],
  "level": 2,
  "concurrency": 100,
  "store_results": true,
  "callback_url": "https://your-app.com/webhook",
  "callback_batch": 200
}

Also accepts Content-Type: text/csv with a CSV file body.

See Bulk Verification for full documentation.

GET /v1/bulk/:id

Get job status.

{
  "job": {
    "id": "abc123",
    "status": "running",
    "total": 5000,
    "done": 3200,
    "failed": 12,
    "level": 2
  }
}

GET /v1/bulk/:id/results

Get paginated results. Query params: offset (default 0), limit (default 1000, max 5000).

GET /v1/bulk/:id/download

Download results as CSV file.

Status Codes