Docs/Authentication

Authentication

Learn how to authenticate your API requests using API keys.

All API requests require authentication using a Bearer token in the Authorization header. Your API key acts as your Bearer token.

API Key Types

Production

Use for production requests. Starts with rv_live_

rv_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Sandbox

Use for development and testing. No credits consumed. Starts with rv_test_

rv_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Include your API key in the Authorization header with the Bearer prefix:

Header

Authorization: Bearer rv_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Full Example (cURL)

curl https://api.rocketverifier.com/v1/credits \
  -H "Authorization: Bearer rv_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Store your API keys in environment variables, not in your source code.

Never commit API keys to version control or share them publicly.

Create new keys periodically and revoke old ones from your dashboard.

API keys should only be used server-side. Use RocketShield for client-side verification.

401

{
  "error": {
    "code": "unauthorized",
    "message": "API key required",
    "details": null
  }
}

401

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key",
    "details": null
  }
}

Create a free account to get your API key and start verifying emails.