Getting Started/Authentication

Authentication

Learn how to authenticate your API requests using Bearer tokens.

API Keys

All API requests require authentication using an API key. You can generate API keys from your dashboard.

Keep your API keys secure

Do not share them in public repositories, client-side code, or expose them in any way. If you believe your key has been compromised, regenerate it immediately from the dashboard.

Bearer Token Authentication

Include your API key in the Authorization header using the Bearer scheme:

Header

Authorization: Bearer YOUR_API_KEY

Example Request

cURL

curl -X POST https://api.vera.com/enrich \
  -H "Authorization: Bearer sk_live_abc123xyz..." \
  -H "Content-Type: application/json" \
  -d '{"url": "stripe.com"}'

API Key Types

sk_live_Production

Use for production applications. Requests count against your plan quota.

sk_test_Test

Use for development and testing. Limited functionality, does not count against quota.

Authentication Errors

401MISSING_API_KEY

No API key was provided in the request

401INVALID_API_KEY

The provided API key is invalid or has been revoked

403INSUFFICIENT_PERMISSIONS

The API key does not have permission for this action

Example Error Response

JSON

401 Unauthorized

{
  "status": "error",
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The provided API key is invalid or has been revoked."
  }
}