Authentication

Getting Your API Key

You can create and manage API keys in your account settings. Premium membership is required to access API keys.

1. Log in to your CLOBr account
2. Navigate to Account → API Keys
3. Click "Create New API Key"
4. Copy your key immediately - it won't be shown again

Using Your API Key

Include your API key in the x-api-key HTTP header with every request:

curl -X GET "https://clobr.io/api/v1/score/9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump" \
  -H "x-api-key: your_api_key_here"

Security Best Practices

• Never expose API keys in client-side code. Always make API calls from your server.
• Use environment variables to store your API keys instead of hardcoding them.
• Rotate keys periodically - you can create new keys and revoke old ones at any time.
• Don't commit keys to version control. Add your env files to .gitignore.

Error Responses

If authentication fails, you'll receive one of these responses:

{"error": "Invalid API key"}

{"error": "Enterprise tier required for batch queries"}

{"error": "Rate limit exceeded. Try again in 60 seconds."}