​

Cost & Credits Management

​

Check Your Balance

GET https://api.zebratruth.ai/v1/usage
Authorization: Bearer {api_key}

{
  "creditsRemaining": 82500,
  "creditsTotal": 83250,
  "creditsUsedThisMonth": 750,
  "periodStart": "2026-04-01",
  "periodEnd": "2026-04-30",
  "tier": "pro"
}

​

Cost Estimates

​

Cost Optimization Strategies

1. Use fast mode unless thorough analysis is needed
2. Cache awareness — Identical content + jurisdictions + platforms returns cached results at 0 credits
3. Single agents — If you only need to re-check one aspect, call the agent directly instead of the full pipeline
4. Batch wisely — Check credits before submitting a batch of async jobs

​

Plans

​

Reading Cost Breakdowns

{
  "totalCredits": 47,
  "agents": [
    { "agent": "jurisdiction", "stage": "A", "credits": 2, "cached": true },
    { "agent": "jurisdiction", "stage": "C", "credits": 11 }
  ]
}

• cached: true — Research stage hit the cache (0 provider cost)
• Stage A = legal research & citation retrieval (cacheable, 30-day TTL)
• Stage C = compliance composition + severity scoring

​

Handling 402 (Insufficient Credits)

{
  "error": "Insufficient credits",
  "creditsRemaining": 3,
  "creditsNeeded": 47,
  "upgradeUrl": "https://developers.zebratruth.ai/billing/upgrade"
}