Skip to main content

Authentication

CheckEmail.dev uses API Keys to authenticate requests.

You must include your API Key in the x-api-key header of every request.

GET /validate?email=... HTTP/1.1
Host: api.checkemail.dev
x-api-key: ce_d_1234567890abcdef...

Managing Keys

You can create multiple API keys in your dashboard.

  • Scoped Permissions: You can create keys restricted to specific actions.
    • validate: Allows verifying email addresses (consumes credits).
    • stats: Allows reading account balance and usage stats.
Security Best Practice

Do not expose your API Key in client-side code (e.g., React, Vue, iOS apps). Always route requests through your own backend server to keep your credentials secret.