Email Verifier
Operations for verifying email addresses
Verify an email
Verify one email address and get its deliverability verdict.
This call is synchronous: the verdict comes back in the response, with no job to poll. Use it for one-off checks, such as validating an address a user just typed in. For a list of addresses use POST /v1/email-validation/ instead, which verifies them in the background.
Verifying an address costs 0.5 credits.
Verify an email › Request Body
emailThe email address to verify.
Verify an email › Responses
OK
The verification result for the submitted address.
successTrue when a verdict was reached, false when verification failed.
job_idReference for this verification, useful when correlating it with your own logs. Nothing is queued, so there is no job to poll.
List email validation jobs
List the bulk email-verification jobs on your account, newest first, each with its status, progress and per-address results.
Synchronous and free: listing jobs costs no credits. Use limit (25 by default) and offset to page through the history. Addresses verified one at a time do not create a job and so never appear here.
query Parameters
limitoffsetList email validation jobs › Responses
OK
idIdentifier of the job.
statuscomplete when every address has been processed, failed when the job could not finish.
created_atWhen the job was created.
updated_atWhen the job last changed.
One verification result per submitted address.
progressPercentage of addresses processed, from 0 to 100.
error_messageWhy the job failed. Empty when it completed normally.
job_typeAlways email_validation for jobs created here.
Verify emails in bulk
Create a job that verifies a list of email addresses and tells you whether each one is deliverable.
Verification runs in the background, so this call returns 202 with a job_id as soon as the job is accepted. Poll GET /v1/email-validation/{job_id}/ for progress and results, or supply a webhook_url and be notified when the job finishes.
Each address verified costs 0.5 credits. Only addresses that come back deliverable (safe or riskier) are charged, and the charge is applied when the job completes.
Verify emails in bulk › Request Body
The addresses to verify, one entry per address.
job_nameYour own label for the job, so you can recognize it later in the Evaboot dashboard.
webhook_urlOptional HTTPS URL to notify when the job finishes. It receives a POST carrying the same payload as the job-retrieval endpoint. Leave empty to poll instead.
Verify emails in bulk › Responses
Accepted
job_idIdentifier of the new job. Pass it to the job-retrieval endpoint to poll for results.
successTrue when the job was accepted.
messageHuman-readable confirmation that the job started.
Get email validation job results
Retrieve one bulk email-verification job, using the job_id returned when you created it.
This is the polling endpoint. While the job is still queued or running it returns 202 with the current status and progress; once every address has been processed it returns 200 with the full list of verdicts. Poll every few seconds, or supply a webhook_url at creation time and skip polling altogether.
Synchronous and free: reading a job costs no credits. The credits for the addresses verified were charged when the job completed.
path Parameters
job_idGet email validation job results › Responses
OK
idIdentifier of the job.
statuscomplete when every address has been processed, failed when the job could not finish.
created_atWhen the job was created.
updated_atWhen the job last changed.
One verification result per submitted address.
progressPercentage of addresses processed, from 0 to 100.
error_messageWhy the job failed. Empty when it completed normally.
job_typeAlways email_validation for jobs created here.