Email Lookup

To get more details about an email address or to check if it is a valid email, you can use the Email Lookup command. To upload and check emails in bulk, please use our Web app.

Check a single email address

This API call allows you to retrieve additional information about an email address, such as mailbox detection, syntax checks, DNS validation, deliverability status, and many more helpful values (see the table below).

To check an email, use:

GET /api/v2/email-lookups/{email}

with the following parameters:

NameRequired?ExamplesDescription
emailYesEmail address

Emails must be checked one by one. You cannot check multiple emails in one request. To upload and check emails in bulk, please use our Web app.

You will receive a response in the following format:

ParameterExampleDescription
addressThe email address passed to the call. 
statusvalidThe email is valid or invalid. 
deliverabilitydeliverableThe delivery status of the email address isdeliverableundeliverable 
or 
unknown.
reason No MX host foundThe reason why the checked email is invalid/undeliverable.
risklowThe risk score of the email ishighmediumlow or null.
addressTypecorporateThe email address type (domain) is free or corporate.
isDisposableAddressfalseThis is be true if the domain is in the list of disposable email addresses, otherwise returns as false.
suggestionNull if nothing is suggested, however, if there is a potential typo in the email address, the closest suggestion is provided.
emailRolewebmasterChecks the mailbox part of the email whether it matches a specific role type (‘admin’, ‘sales’, ‘webmaster’)
exchangemx1.textmagic.comEmail exchange server domain name (MX record value).
preference10MX record preference.
localPartjohnThe local part of the email address.
domainPartsample.comThe domain part of the email address.
isInWhiteListfalsetrue if the email address exists in TextMagic whitelist.
isInBlackListfalsetrue if the email address exists in TextMagic blacklist.
hasMxtruetrue if the email address domain has an MX record.
hasAatruetrue if the email address domain has an A record (IPv4).
hasAaaafalsetrue if the email address domain has an AAAA record (IPv6).