Skip to main content
OrbiSearch validates email addresses through a simple REST API. This guide walks you through making your first verification request and understanding the response.

​
Prerequisites

  • An OrbiSearch account
  • An API key from the dashboard

​
Step 1: Get your API key

Sign in to orbisearch.com and navigate to Dashboard → API. Create a new key and copy it.

​
Step 2: Verify an email address

Call GET /v1/verify with your email address and API key: 
curl "https://api.orbisearch.com/v1/[email protected]" \
  -H "X-API-Key: YOUR_API_KEY"

​
Step 3: Read the response

A successful response looks like this: 
{
  "email": "[email protected]",
  "status": "safe",
  "substatus": "deliverable",
  "explanation": "The mailbox exists and is accepting mail.",
  "email_provider": "Google Workspace",
  "is_disposable": false,
  "is_role_account": false,
  "is_free": false
}
The two most important fields are:
  • status — the overall verdict: safe, risky, invalid, or unknown
  • substatus — the specific reason, such as deliverable, catch_all, or mailbox_not_found

​
Step 4: Act on the result

Use the status field to decide what to do with the address:
StatusRecommended action
safeInclude in your outreach or workflow
riskyDecide based on your risk tolerance — exclude for cold outreach, retain for analytics
invalidRemove from your list — this address will bounce
unknownRe-verify later — typically a transient server issue
Results are cached for 24 hours. If you verify the same address again within that window, you get the cached result at no additional cost.

​
Next steps

Verification statuses

Understand every status and substatus in detail.

Bulk verification

Verify thousands of addresses in a single job.

Handling results

Best practices for acting on verification results in your application.

API reference

Full reference for GET /v1/verify.