​

Authentication

Authorization: Bearer zt_live_your_key_here

​

API Key Types

​

Getting a Key

1. Sign up at developers.zebratruth.ai
2. Navigate to Dashboard → API Keys
3. Click Create Key and choose a name and environment (live or test)
4. Copy the key immediately — it is shown only once

​

Validating Your Key

curl https://api.zebratruth.ai/v1/whoami \
  -H "Authorization: Bearer $ZEBRATRUTH_API_KEY"

{
  "tenantId": "tenant_abc",
  "tier": "pro",
  "creditsRemaining": 82500,
  "creditsTotal": 83250,
  "rateLimitPerMinute": 300
}

{
  "error": "Invalid API key"
}

​

Test Mode

• No cost engine — no credits deducted
• No real LLM calls — responses are pre-built canned scenarios
• Deterministic — same input always produces the same output
• Responses include _meta.mode: "test" so you can detect sandbox mode

{
  "score": 55,
  "decision": "HOLD",
  "checks": [...],
  "_meta": {
    "mode": "test",
    "sandbox": true,
    "creditsCharged": 0,
    "estimatedProductionCost": 47,
    "scenarioId": "claim-violation"
  }
}

​

Idempotency

Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000

• Generate a new UUID for each distinct request
• Reuse the same key to safely retry a failed request
• Prevents duplicate execution and double-charging
• Keys expire after 24 hours

​

Rate Limits