Authentication

All API requests require a valid API key passed as a Bearer token.

Bearer Token

Authenticate by including your API key in the Authorization header of every request:

Authorization: Bearer YOUR_API_KEY

Your API key is a long string starting with ev_. For example:

Authorization: Bearer ev_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Where to find your API key

1. Log in to your account at verimails.com/dashboard
2. Navigate to Settings → API Keys
3. Copy your key

Example authenticated request

curl -X POST https://verimails.com/api/verify/single \
  -H "Authorization: Bearer ev_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"email": "test@example.com"}'

Authentication errors

If your key is missing or invalid, you'll receive a 401 Unauthorized response:

{
  "error": "Unauthorized",
  "message": "Invalid or missing API key",
  "status_code": 401
}