Credits and plans
PAYG is Pay-as-you-go. AYCE is All-you-can-eat.
Requesting metadata does not increase the cost. Add
?metadata=true to
either verification endpoint to include provider, MX, gateway, and reason
details. Set it on your original request; verifying an address again can
consume another credit for a Valid or Invalid result.
For example, 70 Valid, 20 Invalid, and 10 Unknown results cost 90 credits,
with or without metadata. Email verification uses these prices on both plans;
AYCE’s unlimited contact retrieval is shown separately in
credits and plans.
Choose a method
All of a user’s keys and portal session share the real-time endpoint limit.
Contact sales for a higher limit.
The batch runs in the background and processes many addresses from one call.
Verify one address
SetREVENUEBASE_API_KEY to your API key and REVENUEBASE_EMAIL to the
business email address you want to check.
domain, timestamp, mx_record_present, mx_record_checked,
email_provider, security_gateway, and reason. Fields can be missing,
empty, or null when unavailable.
Read statuses and metadata
for the meaning of every field, common reasons, and the distinction between
provider Unknown and verification Unknown. mx_record_checked is an MX
hostname, rather than a status such as “checked”.
For high-volume outbound with Smartlead or Instantly, use email_provider
to group recipients by provider. See provider matching
for Microsoft-to-Microsoft and Google-to-Google sending guidance.
Process a batch
Prepare a UTF-8 CSV with anemail column, or a JSON array of records with an
email field. Include your own reference field to reconnect results to input
records because output order can change.
- Upload the file. Save the returned process_id. The upload itself is free; allow one available credit per input row before processing.
- Poll status every 5 to 10 seconds, slowing down for longer jobs. Stop on COMPLETED, CANCELLED, or ERROR.
- Download the file when complete. Cancelled jobs can have partial output; jobs stopped before processing can have none.
Manage your jobs
These utilities cost 0 additional credits. Contact and company exports
have their own export identifiers and status endpoints.
