Email Validation

Submits an email address to the service to be validated and returns the result of the validation.

Changed on
post/email/validate/v2

Request

Headers

Reference-Idstring nullable

Optional identifier that will be returned in the response to help you track the request. The Reference-Id header value can only contain alphanumeric, '-', '/', '_', ':', ' ', '.', ',', '(' and ')' characters and the value must be less than 256 characters.

Timeout-Secondsinteger nullable

Optional identifier that can specifies the timeout value. The Timeout-Seconds header value must be between 3 and 15.

Add-Metadataboolean nullable

Optional identifier that specify whether the response should return all fields and values, in addition to the main core information.

Request body

emailstring required

The email address that is the subject of the validation. <br> Maximum local part length is 64 and maximum domain part length is 255

Example request

{
  "email": "support@experian.com"
}

Response

You've submitted a successful request and a valid response was returned. Your request may contain confidence level or corrections. This is the only chargeable response code.

Example response

{
  "error": {
    "title": "Bad Request",
    "detail": "The request body was malformed."
  },
  "result": {
    "email": "support@experian.com"
  },
  "metadata": {
    "normalized_email": "support@experian.com"
  }
}

Changes

    • warning

      the optional response header Reference-Id removed for the status 200

    • warning

      the optional response header Reference-Id removed for the status 400

    • warning

      the optional response header Reference-Id removed for the status 401

    • warning

      the optional response header Reference-Id removed for the status 403

    • warning

      the optional response header Reference-Id removed for the status 404

    • warning

      the optional response header Reference-Id removed for the status 406

    • warning

      the optional response header Reference-Id removed for the status 408

    • warning

      the optional response header Reference-Id removed for the status 415

    • warning

      the optional response header Reference-Id removed for the status 429

    • warning

      the optional response header Reference-Id removed for the status 500

    • warning

      the optional response header Reference-Id removed for the status 503

    • warning

      the optional response header Transaction-Id removed for the status 200

    • warning

      the optional response header Transaction-Id removed for the status 400

    • warning

      the optional response header Transaction-Id removed for the status 401

    • warning

      the optional response header Transaction-Id removed for the status 403

    • warning

      the optional response header Transaction-Id removed for the status 404

    • warning

      the optional response header Transaction-Id removed for the status 406

    • warning

      the optional response header Transaction-Id removed for the status 408

    • warning

      the optional response header Transaction-Id removed for the status 415

    • warning

      the optional response header Transaction-Id removed for the status 429

    • warning

      the optional response header Transaction-Id removed for the status 500

    • warning

      the optional response header Transaction-Id removed for the status 503