Skip to content

response-codes.md

Latest commit

 

History

History
143 lines (102 loc) · 4.05 KB

response-codes.md

File metadata and controls

143 lines (102 loc) · 4.05 KB

Response Codes

Understanding OrbiSearch verification results.

Status Values

The status field indicates the overall verification result:

Status Description Action
safe Email verified as deliverable Safe to send
risky Unresolved catch-all domain Discard or segment
invalid Email does not exist or is undeliverable Do not send
unknown Verification could not be completed Retry or skip

safe

The mailbox has been verified to exist and can receive emails. This includes:

  • Standard mailboxes we verified via SMTP
  • Catch-all domain mailboxes we successfully verified using our dual-layer detection

Action: Safe to include in your outreach campaigns.

risky

An unresolved catch-all. The domain accepts all emails, and we were unable to verify whether this specific mailbox exists.

Action: Discard these contacts, or segment them separately and monitor your bounce rate closely if you choose to send.

invalid

The email address is confirmed to be undeliverable. Reasons include:

  • Mailbox does not exist
  • Domain has no email servers
  • Invalid email syntax
  • Disabled or deactivated account
  • Full inbox

Action: Remove from your list. Sending to invalid emails damages your sender reputation.

unknown

Verification could not be completed due to technical issues.

Action: Depends on the substatus (see below).

Substatus Values

The substatus field provides additional context:

safe

Substatus Description
deliverable Mailbox verified as deliverable

risky

Substatus Description
catch_all Unresolved catch-all domain

invalid

Substatus Description
invalid_syntax Email format is invalid
no_mx_records Domain has no email servers
mailbox_not_found Specific mailbox does not exist
mailbox_disabled Email account has been deactivated
mailbox_full Mailbox is full
smtp_unreachable Cannot connect to email server
null Generic invalid (rare)

unknown

Substatus Description
greylisted Server delayed verification; auto-retried in bulk jobs
verification_blocked Temporarily blocked by provider; retry later
technical_issue Mail server issue; retry may not help

Email Provider Detection

The email_provider field identifies the email service:

Provider Type Description
Google Workspace B2B Business Google accounts
Gmail B2C Personal Gmail accounts
Microsoft Outlook B2B Business Microsoft 365 accounts
Hotmail B2C Personal Microsoft accounts
Yahoo B2C Yahoo Mail
Apple iCloud B2C Apple iCloud Mail
ProtonMail Mixed ProtonMail
Proofpoint B2B Proofpoint-protected domains
Mimecast B2B Mimecast-protected domains
Barracuda B2B Barracuda-protected domains
GoDaddy Mixed GoDaddy email hosting
Rackspace B2B Rackspace email hosting
Other Mixed Self-hosted or other providers

Boolean Flags

Additional flags for filtering:

Flag Description
is_disposable true if temporary email service (Mailinator, etc.)
is_role_account true if generic role address (info@, support@, etc.)
is_free true if free email provider (gmail.com, yahoo.com, etc.)

Filtering Examples

B2B campaigns (exclude personal emails):

is_free = false
is_role_account = false

Exclude disposable emails:

is_disposable = false

Decision Matrix

Status Substatus Recommendation
safe deliverable Send
risky catch_all Discard or segment carefully
invalid any Remove from list
unknown greylisted Auto-retried in bulk jobs
unknown verification_blocked Retry later
unknown technical_issue Skip (mail server issue)