Email validation

Validate email addresses by checking whether they're capable of receiving email, the address has correct syntax, presence of MX record and whether the server is a catch all.

Lookup cost: 1.5 credits

Email validation with JavaScript example

See the Pen Email validation with Javascript by Allies Computing (@alliescomputing) on CodePen.

Additional example code

Useful support articles

API reference

If you want to customise our examples, create your own user interface or integrate our API on another platform, you can find all the request parameters and response details below.

If you require further help or have any questions feel free to contact our support team.

Request structure

http://ws.postcoder.com/pcw/[api-key]/emailaddress/[email-address]

Optional parameters

format xml | json (default unless header of application/xml is detected)

Notes

  • Email requests are logged within your account but the actual search term is not stored for reasons of data protection
  • Some email providers impose restrictions on validation; in these cases, a warning tag in the response will advise "Only reduced validation is available for this domain"
  • Enhanced checks will typically complete in within a second, however some may take up to 5 seconds.

Response examples

Request: http://ws.postcoder.com/pcw/PCW45-12345-12345-1234X/emailaddress/joe@bloggs.com?format=xml

<EmailValidation xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <state>Mailbox Does Not Exist</state>
    <valid>false</valid>
    <score>0</score>
    <processtime>697</processtime>
</EmailValidation>

Request: http://ws.postcoder.com/pcw/PCW45-12345-12345-1234X/emailaddress/joe@bloggs.com?format=json

{
    "state":"Mailbox Does Not Exist",
    "valid":false,
    "score":"0",
    "processtime":"697"
}

Response field descriptions

Field name Data type Description Example
valid Boolean Email is valid or not true
state String Message about validation (full list below) Mailbox Validation Timeout
score Integer 0 - 100 Rating for the email, higher is better. 50
processtime Integer Internal time-to-process a request, measured in milliseconds. 697
alternative String Possible suggestion if domain name does not exist (see note below).

Note

  • The API will sometimes return an alternative response field containing a suggested "Did you mean..." style correction. Such as ...@gamil.com which will suggest ...@gmail.com, this is mainly for large email providers such as Gmail, Outlook and Yahoo
  • All response fields should be treated as optional

List of state field messages

Mailbox Does Not Exist
Mailbox Temporarily Unavailable
Mailbox Validation Timeout
Smtp Connection Timeout
Server Temporary Unavailable
Success (Server is Catch All)
Success Domain is Well Known DEA
Domain Does Not Exist

Note

  • DEA stands for Disposable Email Address