Email Batch Cleansing

Data must be provided in a csv file, containing the following columns.

idstringA unique identifier for the row
email_addressstring✔️The email address to be cleansed

It is possible to perform more than one type of cleanse on a single CSV file. For example, an email cleanse could be run on a file, followed by an address cleanse. Make sure that all the required columns are included for each cleanse you wish to perform. The columns can be included in any order. Fields can be left blank if the column is not applicable.

Cleansed File

The returned file will contain the provided columns, and the following:

  • email_match_status
  • email_error_codes
  • cleansed_email_address

The email_match_status column will contain the status of the cleanse.

full_matchThe email address was found and is a perfect match
partial_matchThe email address was found but may not be valid e.g. disposable
no_matchThe provided email address is not valid
errorThere was an error with the email cleanse

The email_error_codes column will contain a comma separated list of reasons why the cleanse wasn't a full match


catch_allThe provider accepts any email even if the mailbox is invalid
high_risk_domainThe email address belongs to a high risk domain
immature_domainThe email address belongs to a newly created domain
is_disposable_addressThe provided email address is disposable
long_term_disposableThe provided email address is a long term disposable email
subdomain_mailerThe email address belongs to a subdomain
tld_riskThere is a risk with the top level domain of the email address
failed_custom_grammar_checkThe custom grammar check for this provider failed
failed_grammar_checkThe grammar check failed
mailbox_does_not_existThe mailbox does not exist for this domain
no_mx_records_for_domainNo mx records for the domain were found
domain_name_invalidThe domain name of the email address does not exist
email_invalidThe provided email address is not valid


dns_server_failureThere was a dns server failure during the cleanse
provider_communication_errorThere was a communication error with the provider of the email address
smtp_errorThere was an error with the smtp
smtp_timeoutThe smtp resulted in a timeout
unknown_server_errorThere was an unknown server error