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/validatePOST /v2/email/validate/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/validate \
  -H "x-key: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"email": "jamie.morgan@acmecorp.com"}'
Response: 
{
  "email": "jamie.morgan@acmecorp.com",
  "deliverability": "DELIVERABLE",
  "role": false,
  "risk": "LOW"
}
Add ?metadata=true to the request URL to include additional enrichment fields in the response.

​
Understand the response fields

FieldValuesWhat it means
deliverabilityDELIVERABLE, UNDELIVERABLE, UNKNOWNWhether the address accepts mail. Use DELIVERABLE for outbound sends.
roletrue / falseRole accounts (support@, info@, admin@) have lower engagement rates. Consider excluding from direct outreach.
riskLOW, MEDIUM, HIGHLikelihood of bounce or spam trap. Filter to LOW for high-confidence sends.

​
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/validate/batch \
  -H "x-key: {YOUR_API_KEY}" \
  -F "file=@emails.csv"
2

Poll for status

curl https://api.revenuebase.ai/v2/jobs/{PROCESS_ID} \
  -H "x-key: {YOUR_API_KEY}"
Poll until 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 verification results for every address in the batch, in the same format as the real-time response.

​
Manage batch jobs

EndpointWhat it does
GET /v2/jobsList active (queued or processing) batch jobs
POST /v2/jobs/{process_id}/cancelCancel a job before it completes

​
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.