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. 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.
Slow checks: if the check is still running after about 25 seconds you get 202 with a job_id instead. The check carries on and is billed the same way; poll GET /v1/email-validation/{job_id}/ for the verdict.
Verifying an address costs 1 credit, whatever the verdict.
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 number of addresses. Per-address results are not included: fetch one job with GET /v1/email-validation/{job_id}/ for those.
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, as returned when you created it.
statusJob status: pending, running, complete or failed.
created_atWhen the job was created.
updated_atWhen the job last changed.
prospect_countNumber of addresses submitted.
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 checked costs 1 credit, whatever the verdict. An address the check could not complete (error) is not charged. The charge is applied when the job completes.
Verify emails in bulk › Request Body
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.
The addresses to verify, one entry per address. Leave empty when sending source.
Read the addresses from a connected integration instead: every lead with an email, up to max_leads read. Cannot be combined with prospects.
write_backWrite each result back onto the record its prospect's source_ref points to, once the job is paid for. Fills empty fields only and never creates a record.
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. It also serves a single verification that answered 202; one whose credits could not be taken returns 402 instead of its verdict.
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.
One entry per integration the statuses are written back to. Empty unless the job was created with write_back.