API REFERENCE

Job Status

Poll this endpoint after a bulk upload. Status transitions: pending → processing → completed (or failed). Requires a JWT session.

Requires a dashboard session

Job status uses a JWT session (logged-in dashboard), not an API key. Poll it from your dashboard or a session authenticated with a Bearer token.

GET/verification/status/{job_id}

Get the status of a verification job.

Poll status

curl https://api.bouncecheck.email/api/v1/verification/status/42 \
  -H "Authorization: Bearer YOUR_JWT"

Response

{
  "id": 42,
  "status": "processing",
  "total_emails": 1000,
  "processed_emails": 430,
  "valid_emails": 390,
  "invalid_emails": 40,
  "created_at": "2026-06-30T10:00:00Z",
  "completed_at": null
}