Authentication

Creating and managing API keys

API keys are sensitive and give access to the data in your account and access to validate emails. Only trusted sources should be given access to these keys to protect your account. If you suspect a key has been compromised reset the key immediately from the corresponding app's dashboard page.

Our API simplifies the authentication schema by using static API keys. To get an API key log into your account and Create New App. After creation, click on in on the overview page and you will see your newly created API key.

If for some reason you need to revoke or change the key, click "reset the API Key" in the the API key section.

You can authenticate your requests by including this API key as the key parameter in the request's query string. See the below samples for examples doing this.

# Key present in request URI
curl --request GET \
--url https://truemail.io/api/v1/verify/single?address_info=1&timeout=100&access_token={api_token}&email={email} \
# Key present in header
curl --request GET \
--url https://truemail.io/api/v1/verify/single?address_info=1&timeout=100&email={email}
—h authorization:{api_key}