Skip to main content
POST
Submit Bulk Verification
Use this endpoint to submit a list of email addresses for asynchronous bulk verification. The API accepts your list, deduplicates it, queues the job, and returns a job_id immediately. Verification happens in the background — you poll GET /v1/bulk/{job_id} to track progress and GET /v1/bulk/{job_id}/results to retrieve results when the job is complete.

Deduplication and async processing

OrbiSearch automatically deduplicates your email list before processing. If you submit 600 addresses but 100 are duplicates, total_emails will be 500 and you will only be charged for 500 verifications. Because bulk jobs run asynchronously, this endpoint returns immediately after accepting the job. Use the returned job_id to poll GET /v1/bulk/{job_id} until the status field reaches complete. You can begin retrieving partial results at any time using GET /v1/bulk/{job_id}/results — see that page for details on fetching results before a job finishes.

Authorizations

X-API-Key
string
header
required

API key for authentication

Body

application/json
Required array length: 1 - 100000 elements
Required string length: 3 - 320
Example:

Response

Successful Response

Response when submitting a bulk verification job.

job_id
string<uuid>
required

Unique job identifier.

Example:

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

status
enum<string>
required

Submission acknowledgement status.

Available options:
submitted
Allowed value: "submitted"
Example:

"submitted"

total_emails
integer
required

Total number of unique emails to verify.

Example:

500

estimated_cost
number
required

Estimated credit cost for this job.

Example:

100