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. This quickstart verifies an email address. To find a work email from a LinkedIn profile URL or a name and company domain instead, start with the email finder guide; authentication works the same way.

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 is the overall verdict: safe, risky, invalid, or unknown
substatus is 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.

Email finder

Find a person’s verified work email from their LinkedIn profile URL, or their name and company domain.

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

Email finder

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

Email finder

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