Skip to main content
GET
/
v1
/
bulk
/
{job_id}
/
results
cURL
curl --request GET \
  --url 'https://api.orbisearch.com/v1/bulk/123e4567-e89b-12d3-a456-426614174000/results' \
  --header 'X-API-Key: YOUR_API_KEY'
{
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "complete",
  "total_results": 500,
  "results": [
    {
      "email": "jane.doe@acme.com",
      "status": "safe",
      "substatus": "deliverable",
      "explanation": "Safe to email. The mailbox exists and is deliverable.",
      "email_provider": "Google Workspace",
      "mx_record": "aspmx.l.google.com",
      "is_domain_catch_all": false,
      "is_secure_email_gateway": false,
      "is_disposable": false,
      "is_role_account": false,
      "is_free": false,
      "confidence": 99
    }
  ],
  "pending_retries": [],
  "retry_count": 0
}

Documentation Index

Fetch the complete documentation index at: https://orbisearch.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Use this endpoint to retrieve the verification results for a bulk job. It returns an array of EmailVerificationResponse objects — one for each email in the job. You can call this endpoint before the job has fully completed to retrieve partial results, though the results array will only contain entries for emails processed so far.

​
Fetching partial results

You do not need to wait for a job to reach complete status before calling this endpoint. If you call it while the job is still in_progress, the response will contain whatever results are available at that moment. The total_results field reflects the number of results in the current response, not the final total for the job. To confirm you have all results, check that the job status is complete and pending_retries is empty ([]) before treating the result set as final. pending_retries is an array of email addresses still queued for automatic greylist retry — an empty array means the job has fully settled.

Authorizations

​
X-API-Key
string
header
required

API key for authentication

Path Parameters

​
job_id
string
required

Response

Successful Response

Results of a completed bulk verification job.

​
job_id
string<uuid>
required

Unique job identifier.

Example:

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

​
status
enum<string>
required

Job status when results were fetched.

Available options:
complete,
partial_complete_retrying
Example:

"complete"

​
total_results
integer
required

Total number of results in this response.

Example:

100

​
results
EmailVerificationResponse · object[]
required

Array of email verification results.

​
pending_retries
string[]

Emails still being retried (greylisted, awaiting MTA retry window).

Example:
["email1@example.com"]
​
retry_count
integer
default:0

Number of emails still being retried.

Example:

5