Usage

GET /v1/organizations/usage

Auth: account token, rk_ or sk_. This is the stats surface read-only tokens exist for: hand an rk_ token to an agent or outside service and it can watch usage.

curl https://api.proxyllm.ai/v1/organizations/usage \
  -H "Authorization: Bearer rk_your_readonly_token"

Response

Totals over the last 30 days, across all routing keys on the account:

{
  "window_days": 30,
  "requests": 18423,
  "tokens": 6817204,
  "cached_tokens": 1473600,
  "cost_usd": 221.09,
  "saved_usd": 92.13
}

Field	Type	Notes
window_days	number	Always 30.
requests	number	Total requests served.
tokens	number	Prompt plus completion tokens.
cached_tokens	number	Tokens served from provider caches.
cost_usd	number	Metered spend. Subscription-backed lanes (Codex, bridge) bill at 0 and are not in this number.
saved_usd	number	What caching saved versus paying full price.

For per-request detail, filters, and date ranges, use the Usage page in the dashboard.

Errors

Status	Code	When
401	(none)	No token sent.
401	invalid_account_token	Unknown or revoked token.
405	method_not_allowed	Method other than GET.
500	server_error	The stats query failed.