Get Started with OrbiSearch

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

Step 2: Verify an email address

Call GET /v1/verify with your email address and API key:

curl "https://api.orbisearch.com/v1/verify?email=jane.doe@acme.com" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://api.orbisearch.com/v1/verify",
    params={"email": "jane.doe@acme.com"},
    headers={"X-API-Key": "YOUR_API_KEY"}
)

result = response.json()
print(result["status"])      # safe | risky | invalid | unknown
print(result["substatus"])   # e.g. deliverable, catch_all, mailbox_not_found

const response = await fetch(
  "https://api.orbisearch.com/v1/verify?email=jane.doe%40acme.com",
  {
    headers: {
      "X-API-Key": "YOUR_API_KEY"
    }
  }
);

const result = await response.json();
console.log(result.status);     // safe | risky | invalid | unknown
console.log(result.substatus);  // e.g. deliverable, catch_all, mailbox_not_found

Step 3: Read the response

A successful response looks like this:

{
  "email": "jane.doe@acme.com",
  "status": "safe",
  "substatus": "deliverable",
  "explanation": "The mailbox exists and is accepting mail.",
  "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
}

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:

Status	Recommended action
`safe`	Include in your outreach or workflow
`risky`	Decide based on your risk tolerance — exclude for cold outreach, retain for analytics
`invalid`	Remove from your list — this address will bounce
`unknown`	Re-verify later — typically a transient server issue

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.

Get Started

Core Concepts

Guides

Get Started with OrbiSearch

Prerequisites

Step 1: Get your API key

Step 2: Verify an email address

Step 3: Read the response

Step 4: Act on the result

Next steps

Verification statuses

Bulk verification

Handling results

API reference

​Prerequisites

​Step 1: Get your API key

​Step 2: Verify an email address

​Step 3: Read the response

​Step 4: Act on the result

​Next steps

Verification statuses

Bulk verification

Handling results

API reference

Prerequisites

Step 1: Get your API key

Step 2: Verify an email address

Step 3: Read the response

Step 4: Act on the result

Next steps