Skip to main content
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 /v1/process-emailPOST /v1/batch-process-email
ResponseImmediateAsync — poll for 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/v1/process-email \
  -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"
}

​
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

For lists of addresses, submit a batch job and poll until it completes.
1

Submit the batch

curl -X POST https://api.revenuebase.ai/v1/batch-process-email \
  -H "x-key: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"emails": ["jamie.morgan@acmecorp.com", "lee.park@globalinc.io"]}'
Returns a process_id to track the job.
2

Poll for status

curl "https://api.revenuebase.ai/v1/batch-process-email-status?process_id={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 -X POST https://api.revenuebase.ai/v1/batch-download \
  -H "x-key: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"process_id": "{PROCESS_ID}"}'
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 /v1/queued-processList queued or in-progress batch jobs
POST /v1/cancel-processCancel 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.