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."
}