Making requests | Documentation v2 | Email Verification API | WhoisXML API

Making requests: API v2

NOTE: Email Verification API version 2 is being deprecated following the launch of version 3, which provides better stability and more accurate results. To learn more about the new version, please visit this specifications page.

  • End of Service (EOS) - After January 31 2024, our development team will stop providing fixes and technical support for this version.
  • End of Life (EOL) - After April 30 2024, this version will be discontinued and queries will no longer be served.

API endpoint

GET https://emailverification.whoisxmlapi.com/api/v2?apiKey=YOUR_API_KEY&emailAddress=support@whoisxmlapi.com
It takes up to a minute to activate your account after the registration.

Postman collection

Postman is a desktop and web application that allows you to make requests to an API from a graphical user interface. We recommend using Postman with WhoisXML APIs endpoints when exploring the APIs functionality, as well as when you are troubleshooting issues with your application.

The WhoisXML API Postman collection is available at the following links:

The collection includes a preconfigured environment. You will need to set up the api_key variable to fire each request. Get your personal API KEY on the My products page. If you have questions related to the API, contact us.

Input parameters: required

apiKey

Get your personal API key on the My products page.

emailAddress

The email address to be verified.

Input parameters: optional

outputFormat

Response output format.

Acceptable values: JSON | XML

Default: JSON

validateDNS

1 results in checking the email address with DNS.

Acceptable values: 0 | 1

Default: 1

validateSMTP

1 results in checking the email address with SMTP.

Acceptable values: 0 | 1

Default: 1

checkCatchAll

1 results in checking if the email provider has a catch-all email address.

Acceptable values: 0 | 1

Default: 1

checkFree

1 results in checking whether the email provider is a free one.

Acceptable values: 0 | 1

Default: 1

checkDisposable

1 results in checking if the address is disposable.

Acceptable values: 0 | 1

Default: 1

_hardRefresh

1 results in getting fresh data.

Acceptable values: 0 | 1

Default: 0

timeout

The maximum number of seconds that a request can be processed.

Minimum acceptable value: 5

cacheEmail

1 allows caching validation results for the faster performance. 0 enforces a strict no-cache policy.

Acceptable values: 0 | 1

Default: 1

Free access

After Sign Up you automatically get a free subscription plan limited to 100 queries.