Skip to main content
POST
/
v1
/
bulk
Submit Bulk Verification
curl --request POST \
  --url https://api.orbisearch.com/v1/bulk \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
[
  "[email protected]",
  "[email protected]",
  "[email protected]"
]
'
{
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "submitted",
  "total_emails": 500,
  "estimated_cost": 100
}
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

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
Example:

"submitted"

​
total_emails
integer
required

Total number of unique emails to verify.

Example:

100

​
estimated_cost
number
required

Estimated credit cost for this job.

Example:

20