Skip to main content
POST
Python SDK

Credits and plans

PAYG is Pay-as-you-go. AYCE is All-you-can-eat. Email verification uses the same per-result prices on both plans. Requesting metadata does not increase the cost. Set metadata=true on the original request to get the reason, provider, and mail-routing details with your result.

When to use this endpoint

  • Check one address while a user is filling in a form or working with a contact.
  • Verify an email you already know, including one retrieved through Contact Enrich or Preview.
  • Use Batch Email Verification for a list in one file.

Example

Set REVENUEBASE_API_KEY to your API key and REVENUEBASE_EMAIL to the business email address you want to check.

Read the result

Use status as the verification outcome. Valid and Invalid each consume one credit; Unknown is inconclusive and consumes zero. Without metadata, the response contains email and status. With metadata, additional fields can be empty or null when unavailable. See statuses and metadata for every field and common reason. Provider Unknown and verification Unknown have different meanings. mx_record_checked contains a hostname. A failed check can return just email and Unknown even with metadata enabled.

Options and limits

Standard users can make 1 request per second on this endpoint. The user’s API keys and portal session share that limit. Contact sales for a higher limit, or use a batch for a list.

Billing and retries

A second verification of the same address can charge again if it returns Valid or Invalid, including when you request metadata on the second call. Unknown is free, but the account can still need an available credit balance before a check starts.

Next steps

Understand statuses and metadata, or verify a list.

Authorizations

x-key
string
header
required

Query Parameters

metadata
boolean
default:false

Include verification metadata at no extra credit cost. False by default; set true for provider, MX, gateway, and reason details. Metadata is included at no extra cost.

Body

application/json
email
string<email>
required

Response

Successful Response

email
string<email>
required
status
enum<string>
required

Primary verification result. Valid and Invalid cost one credit; Unknown costs zero.

Available options:
Valid,
Invalid,
Unknown
domain
string | null

Domain of the submitted address.

timestamp
string | null

Verification timestamp; a string without an offset does not specify a timezone.

mx_record_present
boolean | null

Whether an MX record was detected. Read status for the verification outcome.

mx_record_checked
string | null

MX hostname that was checked; this is not a boolean or status.

email_provider
enum<string> | null

Detected provider. Provider Unknown is independent of the verification status.

Available options:
Google,
Microsoft,
Unknown
security_gateway
string | null

Detected gateway or routing service; can be empty, null, or Unknown.

reason
string | null

Open string explaining the primary result. See the metadata guide for common values.