Skip to main content
GET
Get Bulk Job Status
Use this endpoint to check the progress of a bulk verification job. Poll it periodically after submitting a job via POST /v1/bulk to determine when your results are ready. The response tells you how many emails have been processed, the current job status, and the status of any automatic retries.

Job status values

Retry status values

Authorizations

X-API-Key
string
header
required

API key for authentication

Path Parameters

job_id
string
required

Response

Successful Response

Status information for a bulk verification job.

job_id
string<uuid>
required

Unique job identifier.

Example:

"123e4567-e89b-12d3-a456-426614174000"

status
enum<string>
required

Current job status: pending, in_progress, partial_complete_retrying, complete, failed.

Available options:
pending,
in_progress,
partial_complete_retrying,
complete,
failed
Pattern: ^[a-z_]{1,64}$
Example:

"in_progress"

total_emails
integer
required

Total number of emails in this job.

Example:

500

emails_processed
integer
required

Number of emails processed so far.

Example:

245

submitted_at
string<date-time>
required

When the job was submitted (ISO 8601 timestamp).

Example:

"2024-01-15T10:30:00+00:00"

retry_status
enum<string>
default:none

Retry status: none, pending, partial, complete.

Available options:
none,
pending,
partial,
complete
Example:

"none"

completed_at
string<date-time>

When the job was completed (ISO 8601 timestamp), or null if still in progress.

Example:

null