Skip to content
RocketVerifierDOCS

Email verification API · v1

Know if an email will land before you send it.

One request returns a verdict, the reason behind it and the evidence from the mail server. Verify at signup, clean a list of 100,000, or sync results into your CRM. Unknown results are never charged.

$npm i @rocketverifier/sdk
$pip install rocketverifier
POST /v1/verify200 OK
curl https://api.rocketverifier.com/v1/verify \
  -H "Authorization: Bearer $ROCKETVERIFIER_API_KEY" \
  -d '{"email":"maya@northwind.io"}'

Evidence trace

  1. SYNTAXValid
  2. DNS · MXGoogle
  3. LISTSClean
  4. CATCH-ALLNo
  5. SMTP250 OK
97

deliverablesub_status: none

The mail server confirmed the mailbox. Safe to send.

Start from your goal

What are you building?

Each path is a complete guide with working code, the right endpoints and what to do with every result.

Reading results

Four statuses. One decision: send or not.

Branch on status. Read sub_status for the reason. Unknown results cost nothing.

How to read every result

deliverable

Send.

  • none
  • alias
  • forwarder

undeliverable

Remove.

  • mailbox_not_found
  • account_disabled
  • does_not_accept_mail
  • +3 more

risky

Send with care.

  • catch_all
  • role_based
  • mailbox_full
  • +7 more

unknown

Retry later. Free.

  • dns_error
  • greylisted
  • blocked
  • +3 more

Built for AI agents

Every page is also Markdown.

Add .md to any docs URL, or give your assistant llms-full.txt for the complete docs in one file.

docs.rocketverifier.com/llms-full.txt