Data Quality user documentation
home/Email validation/Email sample code/API reference/POST query

POST query

Asynchronous - posts an email address to the service to be validated. Make a GET /result request to retrieve the results.

Request

https://api.experianmarketingservices.com/query/EmailValidate/1.0/

Note that URLs that do not specify the version number will default to version 1.0.

Parameters

Parameter Valid Values / Examples
Email The input email address, e.g. "anemailexample@gmail.com".
Timeout (optional) The email validation search timeout in seconds. If a timeout occurs, the email certainty status of Unknown will be returned.
  • Default value: 3 seconds (if this parameter is omitted)
  • Maximum: 15 seconds
  • Minimum: 3 seconds
This setting will have an impact on performance and accuracy. A low value (e.g. 3 seconds) might lead to an inaccurate email result of Unknown status; while a higher value will impact the performance of the returned result.
Verbose (optional) A boolean value (true/false) to determine whether to return VerboseOutput information.
  • Default value: False

Sample request object

{
   "Email": "support@gmailcom",
   "Timeout":"5",
   "Verbose":"True"
}

Response

Sample response

HTTP/1.1 204 No Content
Content-Length: 0
Content-Location:https://api.experianmarketingservices.com/result/EmailValidate/1.0/00000000-0000-0000-0000-000000000000
Date: Mon, 01 July 2014 08:15:29 GMT
Email sample code

API reference