Response Attributes

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