Response Attributes

There are a number of variables returned after an API request.

success true | false – Tells you if your API request was successful
user string – Tells you the username of the email in query – bob@gmail.com => bob
domain string – Tells you the domain of the email in query – bob@gmail.com => gmail.com
email string – Returns the email that this response was for – BoB@gmail.com => bob@gmail.com
result string – Tells you whether the email is deliverable or not valid, invalid, risky, unknown
reason string – Explains the reason behind the result in short

Invalid Email
Invalid Domain
Rejected Email
Accepted Email
Low Quality
Low Deliverability
Cannot Connect
Timeout
Invalid SMTP
Unavailable SMTP
Unexpected Error

message string – A more brief message explaining the reason in detail

Invalid Email - Specified email is not a valid email address syntax
Invalid Domain - Domain name does not exist or is not configured to receive email
Rejected Email - Email address was rejected by the SMTP server, email address does not exist
Accepted Email - Email address was accepted by the SMTP server
Low Quality - Email address has quality issues that may make it a risky or low-value address
Low Deliverability - Email address appears to be deliverable, but deliverability cannot be guaranteed
Cannot Connect - Could not connect to SMTP server
Timeout - SMTP session timed out or DNS query timed out
Invalid SMTP - SMTP server returned an unexpected/invalid response
Unavailable SMTP - SMTP server was unavailable to process our request
Unexpected Error - An unexpected error has occurred

risky true | false – Tells you if the email in query is a low-quality risky email
disposable true | false – Tells you whether the email in query belongs to temporary email service provider
free true | false – Tells you whether the email in query belongs to free email service provider
bad true | false – Tells you if the email in query is in spamtrap, complainers or other similar databases
role true | false – Tells you if the email in query belongs to a role rather than an actual person
did_you_mean Null | String– Tells you if the email in query has a typo and offers suggestion bob@gmaiil.com => bob@gmail.com
ev_score float – Tells you the quality of email by allocating a number between 1 (good) and 0 (bad)

<< Back to Email Verification API for Developers