Email Verification Requests & Response Codes

Here is an example of our email verification service API URL:
xverify api request example

You would simply replace the highlighted data with the information you want to verify, by plugging in your own personal account’s API key and trusted domain. It is also important to identify if you want your response results to come back in XML or JSON format.

Each Parameter in the Email Validation API Request

  1. Email (required): This parameter contains the email address that you want to verify.
  2. Type (required): You can set the type to either JSON or XML.
  3. APIkey (required): This is where you insert your API key. You must have an account with us to get access to your APIkey.
  4. Domain (required): This is where you insert your trusted domain. If you make an api call with an unauthorized domain you will get a 503 error unless tests are available.
  5. Secret Key (optional): You can use the secret key to add new trusted domains via the API, this is mostly used by our reseller clients.

Each Tag in the Email Validation Response

example of API response for email verification

  • <address>
    This tag contains the same email address which was entered in the request.
  • <syntax>
    This helps you identify if the email address is in the correct format. If the response is 1 then the email format is good, if the response is 0 then it means the format of the email address is incorrect.
  • <handle>
    This field contains the username part of the email ID. This is the characters before the @ symbol.
  • <domain>
    This is the domain name of the email ID, the characters after the @ symbol.
  • <error>
    This helps you identify if there was an error with your request. When this tag displays “0” then there is no error. Anything else in this tag will indicate there is a problem with the request.
  • <status>
    This tag lets you know if the email address you supplied was either valid of invalid. Valid email addresses are deliverable, and invalid email addresses are not.
  • <auto_correct>
    We are able to auto correct misspellings of major domain names. If the auto correct feature is enabled in your account then the corrected tag will display true and immediately below that you will see an address tag which will display the corrected email address. IF you have auto-correction enabled, but no corrected occurred then you will see that the corrected tag will display false.
  • <message>
    The message tag helps provide more details that help explain the response code.
  • <duration>
    This tag indicates the total execution time for the request.
  • <catch_all>
    This helps you indicate if the email server domain is configured as a catch-all mail server. The results here will display (yes, no, or unknown). Learn more about catch-all domains.

 

Response Codes:

  1. Response Code 1 – Valid Email Address
  2. Response Code 2 – Email Address Does Not Exist
  3. Response Code 3 – Unknown
  4. Response Code 4 – Fraud List
  5. Response Code 5 – High-Risk Email Address
  6. Response Code 6 – Affiliate Is Blocked By Client
  7. Response Code 7 – Complainer Email Address
  8. Response Code 8 – Top Level Domain Blocked By Client
  9. Response Code 9 – Temporary/Disposable Email
  10. Response Code 10 – Keyword is Blocked By Client
  11. Response Code 11 – IP address – Country Not Allowed
  12. Response Code 12 – Block list from Client Settings
  13. Response Code 400 – Missing required fields
  14. Response Code 503 – Invalid API Key/Service Not Active
  15. Response Code 504 – User reach the API Limit