Bulk Verification
With the TrueMail API, you can verify contact lists you already have without needing to upload them to the dashboard.
post
https://truemail.io
/api/v1/tasks/bulk?access_token={api_key}
Verify list of emails
get
https://truemail.io
/api/v1/tasks/{task_id}/status?access_token={api_key}
Get bulk verify status
get
https://truemail.io
/api/v1/tasks/{task_id}/download?access_token={api_key}
Download bulk verify result
Read more about the result statuses here.

Job Status

Job status indicates what step the job is currently in. This will be the primary property you'll want to check to determine what can be done with the job.
Status
Description
Not processed
The job has not yet run and is waiting to be started.
Processing
The job is currently either running a sample or full verification.
Finished
The job has completed verification and the results are ready for download.
Failed
The job failed, typically this is due to poorly formatted data.

Totals

There are several items in the total object that give you an overview of verification results. These numbers are updated periodically during the verification process. Most of these properties correspond directly with the verification result codes; the other properties are explained below.
Property
Description
records
The number of rows we found in your file. This may include whitespace, empty rows, and other rows that don't contain syntactically correct emails.
billable
The number of rows we found syntactically correct emails in. This is number of credits processing this job will consume.
processed
The total number of emails that have been processed so far.
duplicates
The number of rows that contain duplicated emails. This is not the number of unique duplicates but the total of every instance.
bad_syntax
The number of records that do not contain data that looks like an email. This may include whitespace and empty rows as well as bad data.
Copy link
On this page
post
Verify list of emails
get
Get bulk verify status
get
Download bulk verify result
Job Status
Totals