TrueList.io API documentation (0.2.1)

Shows all information about the currently logged in user.

Verify up to 3 email addresses. Verification will happen inline during the api request.

Note: If email validation takes over 30 seconds, this request will time out.

Upload a list of emails to verify. You can either of the following (but not both):

• A data parameter that represents a json array of email data. Should be in the format of [['email@email.com'], ['email2@email.com']]. Each row can also contain arbitrary data, which is useful for supplying external ids or other identifying information. This data will be returned in the annotated csv result files. However, one element in the row array must be an email address. Needs at least 2 rows of data to be valid.
• A binary file upload via the file parameter documented below.

Note that batches are processed in the background. To check on the status of a list, you have a couple of options:

• Poll the status of your batch's progress by GETing the batch you created by its uuid.
• Supply a webhook_url when creating the batch. TrueList will makd a POST request to the url you supplied when the batch is completed. When we call your url, we'll supply the batch_id in the body of the request. Also note that counts are not updated until the batch is completed.