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 https://api.quickemailverification.com/v1/verify

Request parameters

The following parameters are required as query string for this API endpoint.

apikeystringRequiredYour secret API key to authenticate the request.
emailstringRequiredAn email 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 "https://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",
    "mx_record":"us2.mx1.mailhostbox.com",
    "mx_domain":"mailhostbox.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 the 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 the 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)

  • mx_record string - The preferred MX record of the email domain. This field contains an empty string when MX record is not available.

  • mx_domain string - The domain name of the MX host. This field contains an empty string when MX record is not available.

  • 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.

Go library for email verification

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