Skip to main content
Use Email Verification when you already have an address and want to check its current verification status. Use a single check for one address or a batch file for a list.

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

Set REVENUEBASE_API_KEY to your API key and REVENUEBASE_EMAIL to the business email address you want to check.
The response always identifies the address and its primary status. Metadata can include 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 an email 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.
  1. Upload the file. Save the returned process_id. The upload itself is free; allow one available credit per input row before processing.
  2. Poll status every 5 to 10 seconds, slowing down for longer jobs. Stop on COMPLETED, CANCELLED, or ERROR.
  3. Download the file when complete. Cancelled jobs can have partial output; jobs stopped before processing can have none.
Each processed row includes its status and, when requested, metadata. Downloading results is free. A completed job can contain Unknown results; its processing state describes the job, while each row’s status describes that address.

Manage your jobs

These utilities cost 0 additional credits. Contact and company exports have their own export identifiers and status endpoints.