Authentication
In this guide you can learn more about how you can authenticate yourself for the API
API key
Using the Valid Identities API requires authentication so that Valid Identities knows who is making requests and what permissions you have. Create an API key to grant access to the API to perform actions
To create an API key, navigate to the Valid Identities Dashboard, navigate to API keys and click Create API key.
Important:
Keep the API key in a secure vault. Do not share the API key with customers to prevent depleting your quota prematurely.
By default, we enforce CORS policies to prevent accidental credential exposure. If you still want to use our API client side, let us know your use case.
Use the API key
The API key should be sent in the Authorization
HTTP header as Bearer {API KEY}
. For example:
curl 'https://api.valididentities.com/emails/validate' \
--header 'Authorization: Bearer {API_KEY}' \
--header 'Content-Type: application/json' \
--data '{ "domains": ["[email protected]"] }'
Error handling
If the provided API key is not valid or expired the API will respond with the standard 401 Unauthorized
error.
{
"message": "Unauthorized."
}