Usage and credits

GET /v1/usage

Returns rolling rate-limit usage and credit balance.

{
  "rate_limit": {
    "caller_id": "default",
    "windows": [
      {"name": "hour", "duration_seconds": 3600,  "turns": 5, "max_turns": 120,  "tokens": 31137, "max_tokens": 5000000,  "enabled": true},
      {"name": "day",  "duration_seconds": 86400, "turns": 5, "max_turns": 1000, "tokens": 31137, "max_tokens": 50000000, "enabled": true}
    ]
  },
  "credits": {
    "enabled": true,
    "mode": "soft",
    "balance": 99961.99
  }
}

balance is the credits remaining for your tenant. The exact debit per call depends on what the agent does — read balance before and after a call if you want to see the precise impact.

Modes:

• soft — debits recorded, never reject.
• hard — debits recorded AND a turn is rejected with 402 Payment Required when balance falls below the per-turn minimum.

If you hit a 402, contact Pokee for a top-up.