Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.revenuebase.ai/llms.txt

Use this file to discover all available pages before exploring further.

Use the Email Verification API to check whether email addresses are deliverable — in real time for single addresses, or asynchronously for lists.

​
Choose the right method

Real-timeBatch
Use whenValidating at point of entry (form submission, CRM sync)Cleaning a list of 10+ addresses
EndpointPOST /v2/email/verifyPOST /v2/email/verify/batch
ResponseImmediateAsync — poll job status, then download results
Best forLive enrichment, single lookupsBulk list cleaning, pre-send scrubbing

​
Verify a single email

curl -X POST https://api.revenuebase.ai/v2/email/verify \
  -H "x-key: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"email": "jamie.morgan@acmecorp.com"}'
Response: 
{
  "email": "jamie.morgan@acmecorp.com",
  "status": "Valid"
}
Add ?metadata=true to include additional fields in the response: 
{
  "email": "jamie.morgan@acmecorp.com",
  "status": "Valid",
  "domain": "acmecorp.com",
  "timestamp": "2024-01-15T10:30:00",
  "mx_record_present": true,
  "mx_record_checked": "checked",
  "email_provider": "Google",
  "security_gateway": null,
  "reason": null
}

​
Understand the response fields

FieldValuesWhat it means
statusValid, Invalid, UnknownWhether the address is deliverable. Use Valid for outbound sends. Deducts 1 credit on Valid or Invalid.
domainstringDomain of the email address. Returned with ?metadata=true.
mx_record_presenttrue / falseWhether a valid MX record exists for the domain. Returned with ?metadata=true.
email_providerGoogle, Microsoft, UnknownDetected email provider. Returned with ?metadata=true.
security_gatewaystringDetected security gateway, if any. Returned with ?metadata=true.
reasonstringReason for Invalid or Unknown status. Returned with ?metadata=true.

​
Process a batch

Submit a .csv or .json file and track the job using the Jobs endpoints.
1

Submit the batch

Upload your file in a single request. Returns a process_id to track the job.
curl -X POST https://api.revenuebase.ai/v2/email/verify/batch \
  -H "x-key: {YOUR_API_KEY}" \
  -F "requested_file=@emails.csv"
2

Poll for status

curl https://api.revenuebase.ai/v2/jobs/{PROCESS_ID} \
  -H "x-key: {YOUR_API_KEY}"
Poll until current_status is COMPLETED. Use a reasonable interval (e.g. every 5–10 seconds for small batches).
3

Download the results

curl https://api.revenuebase.ai/v2/jobs/{PROCESS_ID}/download \
  -H "x-key: {YOUR_API_KEY}"
Returns the processed output file with a status column added for each address.

​
Manage batch jobs

EndpointWhat it does
GET /v2/jobsList active (queued or processing) batch jobs
GET /v2/jobs/{process_id}Get current status of a specific job
POST /v2/jobs/{process_id}/cancelCancel a job before it completes
GET /v2/jobs/{process_id}/downloadDownload results when the job is complete

​
Next steps

Verify a single email

Full parameter and response reference for real-time verification.

Process emails in batch

Full reference for submitting and downloading batch jobs.