Individual Email Validation

cURL

curl --request GET \
  --url https://api.addressy.com/EmailValidation/Interactive/Validate/v2.00/json6.ws

{
  "Items": [
    {
      "ResponseCode": "Valid",
      "ResponseMessage": "Valid",
      "EmailAddress": "[email protected]",
      "UserAccount": "testing",
      "Domain": "test123.com",
      "IsDisposableOrTemporary": "False",
      "IsComplainerOrFraudRisk": "False",
      "Duration": "0.526",
      "Reason": "Fault Reason",
      "Risk": "High"
    }
  ]
}

GET

EmailValidation

Interactive

Validate

v2.00

json6.ws

cURL

curl --request GET \
  --url https://api.addressy.com/EmailValidation/Interactive/Validate/v2.00/json6.ws

{
  "Items": [
    {
      "ResponseCode": "Valid",
      "ResponseMessage": "Valid",
      "EmailAddress": "[email protected]",
      "UserAccount": "testing",
      "Domain": "test123.com",
      "IsDisposableOrTemporary": "False",
      "IsComplainerOrFraudRisk": "False",
      "Duration": "0.526",
      "Reason": "Fault Reason",
      "Risk": "High"
    }
  ]
}

This method will consume credit.

Query Parameters

Key

string

required

The key to use to authenticate to the service.

string

required

The email address to verify.

Timeout

integer

The time (in milliseconds) you want to give for the valiation attempt to be executed within. Value must be between 1 and 15000 (values outside of these ranges will fallback to the default of 15000).

AdditionalFields

string

The option to return additional fields

Response

Success

Items

object[]

Show child attributes

Items.ResponseCode

string

Valid - The email address has been fully validated (including the account portion). Valid_CatchAll - The domain has been validated but the account could not be validated. Invalid - The email address is invalid and shouldn't be accepted. Timeout - The validation could not be completed within the timeout specified (try increasing the timeout value).

Items.ResponseMessage

string

A textual description of the ResponseCode returned

Items.EmailAddress

string

The email address that verification was attempted on.

Items.UserAccount

string

The account portion of the email address provided.

Items.Domain

string

The domain portion of the email address provided.

Items.IsDisposableOrTemporary

boolean

Whether the email address provided is a disposable mailbox (some companies create temporary mailboxes which shouldn't be used for marketing communications).

Items.IsComplainerOrFraudRisk

boolean

This field is no longer valid and will always return False

Items.Duration

number

The duration (in seconds) that the email validation took (maximum timeout enforced at 15 seconds). We recommend a high timeout (at least 5 seconds) value as it will minimise the number of "Timeout" responses returned.

Items.Reason

string

The Reason the email wasnt valid

Items.Risk

string

High, Medium, Low or Unknown. This score is an aggregated analysis of all the email fields returned and gives an indication of whether mail should be sent to that address. Higher risk indicates a greater likelihood that the email will bounce.

Bulk Email Validation

Individual Phone Validation

⌘I

Getting started

Endpoints

Individual Email Validation

Query Parameters

Response