Single Validation

GET https://app.pilotverify.net/api/validate

Perform a single email validation request.

🚧

IMPORTANT NOTE:

If you are going to use this API within a sign-up form, you must consider Deliverable, Catch-all and Unknown statuses as valid, so you do not miss out on any sign-ups.

Response Parameters:

Parameter	Type	Definition
success	[0, 1]	Is your call successful or not (0: no, 1: yes) If your credits are zero or you have provided an invalid API key, you will receive a 0 response.
data.email	[email]	The email address you are requesting to validate.
data.email_status	[Valid, Invalid, Risky, Unknown]	An enum to describe how confident we are that the recipient address is real: valid, risky, invalid and unknown.
data.disposable_email	[true, false]	Is the address provided by a known disposable email address provider?
data.dns_records_validation	[true, false]	Does the server accept mails?
data.mx_found	[true, false]	Can the mail exchanger of the email address domain be contacted successfully?
data.mx_record	[string]	FQDN (Fully Qualified Domain Name) of the mail server.
data.full_inbox	[true, false]	Is the inbox of this mailbox full?
data.catch_all	[true, false]	Is this email address a catch-all address?
data.deliverable	[true, false]	Is an email sent to this address deliverable?
data.disabled	[true, false]	Has this email address been disabled by the email provider?
data.valid_syntax	[true, false]	Is the address syntactically valid?
data.domain	[string]	The domain name of the email, i.e. the part after the "@" symbol.
data.account	[string]	The username of the email, i.e. the part before the "@" symbol.
data.did_you_mean	[string]	If you use a misspelled email address like [email protected], the validation engine tries to suggest the corrected email address.

Other Responses

The response you get when your credits have been used:

JSON

HTTP/1.1 402 Payment Required
{
  "success":"0",
   "data":{
      "error":"credits low",
   }
}

The response you get when the API key is invalid:

JSON

HTTP/1.1 401 Unauthorized

{
    "success": 0,
    "data": {
        "error": "invalid api key"
    }
}