Authentication

All Verdict APIs use API key authentication to secure your requests and identify your account.

Obtaining an API Key

API keys are available to users with an active PRO subscription:

1. Log in to your Verdict dashboard 
2. Navigate to Settings > API Keys 
3. Your new API key will be displayed - copy it immediately as it won’t be shown again

Using Your API Key

Include your API key in the Authorization header with each request:

Authorization: Bearer YOUR_API_KEY

Example with curl:

curl -X POST https://www.caseverdict.com/api/v1/screen \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "record": {
      "firstName": "John",
      "lastName": "Doe",
      "practiceArea": "Personal Injury",
      ...
    }
  }'

API Key Security

Protect your API keys by following these best practices:

• Never share your API key in public repositories, client-side code, or with unauthorized users
• Use environment variables to store API keys in your applications
• Rotate keys periodically for enhanced security

Error Responses

If your authentication fails, you’ll receive one of these error responses:

{
  "error": "Invalid or missing API key"
}

{
  "error": "User does not have an active subscription"
}

{
  "error": "User's plan does not have access to the API"
}

Rate Limiting

API requests are subject to rate limiting based on your subscription plan. Current limits:

• PRO Plan: 100 requests per minute

When you exceed these limits, you’ll receive a 429 Too Many Requests response:

{
  "error": "Rate limit exceeded. Please try again later."
}