Authentication

You'll need to authenticate your requests to access any of the endpoints in the emailvalidation.io API. In this guide, we'll look at how authentication works. emailvalidation.io offers two ways to authenticate your API requests: API key as GET parameter, or via request header.

GET query parameter

You can pass your API key along with every request by adding it as a query parameter apikey

Example request with authentication via get request

curl "https://api.emailvalidation.io/v1/status?apikey=YOUR-API-KEY"

Please don't commit your emailvalidation.io password to GitHub!

HTTP Header

The recommended way to authenticate with the emailvalidation.io API through a HTTP request header:

Example request with authentication via header

curl "https://api.emailvalidation.io/v1/status" \
  -H "apikey: YOUR-API-KEY"

Always keep your token safe and reset it if you suspect it has been compromised.

Using an SDK

If you use one of our official SDKs, you won't have to worry about any of the above — fetch your access token from the emailvalidation.io dashboard and the client library will take care of the rest. All the client libraries use header authentication behind the scenes.