Loqate

Developer API  |  Everything Location  |  /email/verify

Everything Location - /email/verify

Attempts to validate the domain, account, and type of an email address.

Note: only old everythinglocation keys will work with this service.

Resource URL

https://api.everythinglocation.com/email/verify

Resource Information

Preferred method GET, POST
Response formats JSON, XML, HTML
Requires authentication? Yes, valid API key
Chargeable? Yes

Back to top

Request Parameters


Name Descrition
lqtkey
Required
A valid API key with sufficient credit available to process the requested transactions.

Example: BFtd2UpC8Gl1jU1pPnDZIVpoz2XnBMyWEfVcAfoI
email
Required
The full email address to be submitted for verification. This endpoint supports only one email address per call.

Example: ...email=john.doe@everythinglocation.com

Back to top

Response Parameters


Name Descrition
Status The result of your call. "OK" indicates success, any other status indicates an error.

Example: "Status":"OK"
email[] The array containing the response. Each result will contain the following fields:
  • email: the email address as entered at input
  • host_domain: the domain part of the input email address
  • email_status: can be valid, invalid, accept_all, or unknown
  • secondary_status (not returned when empty): possible field values include
    • role_address
    • disposable
    • email_address_invalid (if email_status = invalid)
    • email_domain_invalid (if email_status = invalid)
    • email_account_invalid (if email_status = invalid)

When email_status = unknown, the process on the given record is not charged.
Sample JSON output[] is enclosed below.

Back to top

Example Request


GET http://api.everythinglocation.com/email/verify
?lqtkey=BFtd2UpC8Gl1jU1pPnDZIVpoz2XnBMyWEfVcAfoI
&email=john.doe@everythinglocation.com

Back to top

Example Response


200 OK
Content-Type: application/json; charset=utf8
Date: Wed, 14 Feb 2016 12:09:25 GMT
Server: Apache
X-Powered-By: PHP/5.4.16
Content-Length: 1912
Connection: keep-alive
{
   "Status" : "OK",
   "email" : [
      {
         "email" : "john.doe@everythinglocation.com",
         "host_domain" : "everythinglocation.com",
         "email_status" : "valid"
      }
   ]
}

Back to top

Take a trial - no obligation, full support Get started