Emails

Email Validation

Validates an email address and reports whether it is deliverable.

Requires an API Key licensed for email validation. A query over 320 characters is rejected.

A validated address decrements your lookup balance. An address the API cannot check returns unknown and costs no lookup. An address whose domain does not resolve, or publishes no MX records, returns not_deliverable and also costs no lookup. Only those two domain failures populate suggestions. Every other response returns an empty list.

get/emails

Request

  • Base URL: https://api.addresszen.com/v1
  • URL: https://api.addresszen.com/v1/emails
  • Auth: HTTP bearer

Query parameters

api_keystring

API Key

Your unique identifier that allows access to our APIs.

Begins ak_. Available from your dashboard.

querystring required

Specifies the email address to validate

tagsstring

Tags

A comma separated list of tags to query over.

Useful if you want to specify the circumstances in which the request was made.

If you specify multiple tags, the response comprises only requests that satisfy all of them. Searching "foo,bar" queries only requests tagged both "foo" and "bar".

Response

Success

code2000 required
message'Success' required

Example response

{
  "result": {
    "suggestions": [
      "corrected_email@example.com"
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.