This API endpoint is ideal for verifying single email at its entry level. You can verify an email to check its validity before allowing it to enter your email database.

API endpoint

GET http://api.quickemailverification.com/v1/verify

Request parameters

Following list of parameters are required as query string for this API endpoint.

apikeystringRequiredYour secret API key to authenticate request.
emailstringRequiredEmail address to be verified.

Example request and response

To verify an email, f.e. richard@quickemailverification.com, a request should be made as follows :

curl --get --include "http://api.quickemailverification.com/v1/verify?email=richard@quickemailverification.com&apikey=s34abb05939ffbf107ef420da8f007b0a62a8e76db58436a8d39fbba2903"

Which should respond something like :

{
    "result":"invalid",
    "reason":"rejected_email",
    "disposable":"false",
    "accept_all":"false",
    "role":"false",
    "free":"false",
    "email":"richard@quickemailverification.com",
    "user":"richard",
    "domain":"quickemailverification.com",
    "safe_to_send":"false",
    "did_you_mean":"",
    "success":"true",
    "message":null
}

API response information

A successful API call responds with the following values:

  • result string - The verified results will be: valid, invalid, unknown

  • reason string - Reason definitions are as below:

    • invalid_email - Specified email has invalid email address syntax
    • invalid_domain - Domain name does not exist
    • rejected_email - SMTP server rejected email. Email does not exist
    • accepted_email - SMTP server accepted email address
    • no_connect - SMTP server connection failure
    • timeout - Session time out occurred at SMTP server
    • unavailable_smtp - SMTP server is not available to process request
    • unexpected_error - An unexpected error has occurred
    • no_mx_record - Could not get MX records for domain
    • temporarily_blocked - Email is temporarily greylisted
    • exceeded_storage - SMTP server rejected email. Exceeded storage allocation
  • disposable true | false - true if the email address uses a disposable domain
  • accept_all true | false - true if the domain appears to accept all emails delivered to that domain
  • role true | false - true if the email address is a role address (manager@example.com, ceo@example.com, etc)
  • free true | false - true if email address is from free email provider like Gmail, Yahoo!, Hotmail etc.
  • email string - Returns a normalized version. (Niki@example.com -> niki@example.com)
  • user string - The local part of an email address. (niki@example.com -> niki)
  • domain string - The domain of the provided email address. (niki@example.com -> example.com)
  • safe_to_send true | false - true if the email address is safe for deliverability
  • did_you_mean string - Returns email suggestions if specific typo errors found in email
  • success true | false - true if the API request was successful
  • message string - Describes API call failure reason

Along with above API response, an HTTP response header "X-QEV-Remaining-Credits" will return the total number of credits left (including daily subscription credits and persistent credit) in the account. Check Kick Start with Email Validation API to know about "X-QEV-Remaining-Credits" and list of all possible HTTP response codes for API.

PHP library for email verification

If you are a PHP developer, you can use QuickEmailVerification PHP library for email verification. Check more details for PHP library at Github.

Node.js library for email verification

Node.js developers can integrate QuickEmailVefication in their application using our Node.js library for email verification. Read more about Node.js library at Github.

Python library for email verification

If you are a Python developer, you can use QuickEmailVefication Python library for email verification. Read more about Python library at Github.

Ruby library for email verification

If you are a Ruby developer, you can use QuickEmailVefication Ruby library for email verification. Read more about Ruby library at Github.