---
title: "Month-to-date IC Credits usage: per provider, per model, per key, last events"
method: GET
path: "/api/credits/admin/usage"
tags: ["keys"]
---

# Month-to-date IC Credits usage: per provider, per model, per key, last events

`GET /api/credits/admin/usage`

## Request

- Base URL: `https://www.immersivecommons.com`
- URL: `https://www.immersivecommons.com/api/credits/admin/usage`
- Auth: one of:
  - API key in cookie `__session`
  - HTTP bearer

Clerk operator session OR an agt_ token carrying `admin:llm_keys`. The HTTP twin of the MCP tool `ic_credits_admin_usage`. Reads the meters the ic13 gateway writes (metered in USD against a monthly cap) and writes nothing. Fail-soft: an unreadable counter reads as 0.

## Response `200`

Month-to-date usage.

- AdminLlmUsageResponse: Month-to-date IC Key usage read straight off the gateway's meters. Every figure is fail-soft: an unreadable counter reads as 0, never as an error.
  - `ok` boolean, required
  - `month` string, required: YYYY-MM (UTC) the month-to-date figures cover.
  - `week_of` string, required: Monday date (YYYY-MM-DD) the per-key weekly_used figures cover.
  - `generated_at` string, required
  - `providers` object, required
    - `nebius` LlmProviderMonthUsage, required
      - `tokens_in` integer, required
      - `tokens_out` integer, required
      - `cost_usd` number, required: USD IC paid this month (UTC). 0 for a flat-plan provider.
      - `requests` integer, required
      - `cap_usd` number, nullable, required: The gateway's monthly USD cap for this provider; null when the provider has none.
      - `cap_pct` number, nullable, required: cost_usd / cap_usd as a percentage, one decimal; null without a cap.
    - `zai` LlmProviderMonthUsage, required
      - `tokens_in` integer, required
      - `tokens_out` integer, required
      - `cost_usd` number, required: USD IC paid this month (UTC). 0 for a flat-plan provider.
      - `requests` integer, required
      - `cap_usd` number, nullable, required: The gateway's monthly USD cap for this provider; null when the provider has none.
      - `cap_pct` number, nullable, required: cost_usd / cap_usd as a percentage, one decimal; null without a cap.
  - `models` object[], required: Per-model month-to-date, cost desc then tokens desc; rows with no traffic are omitted.
    - `model` string, required
    - `provider` string, required
    - `tokens_in` integer, required
    - `tokens_out` integer, required
    - `cost_usd` number, required
    - `requests` integer, required
  - `keys` object[], required: One row per live proxy key the audit ring can see (never a plaintext). Month cost desc.
    - `prefix` string, required: Display prefix of the minted key.
    - `kind` 'workshop' | 'member' | 'benchmark', required
    - `requester_name` string, required
    - `weekly_used` integer, required: This week's tokens (informational on a usd_budget key).
    - `weekly_cap` integer, nullable, required: Legacy weekly-token keys only; null otherwise.
    - `month_cost_usd` number, required
    - `budget_usd` number, nullable: The key's USD budget; null on a legacy key without one.
    - `budget_period` 'month' | 'lifetime' | 'null', nullable
    - `budget_used_usd` number: Spent against the budget: month cost, or lifetime total for a lifetime budget.
    - `models` string[], required: Every model id this key has used.
    - `default_model` string, nullable
  - `keys_audit_window` integer: How many audit entries the key enumeration could see; keys whose approval rolled off the ring are not listed.
  - `events` object[], required: The last 50 gateway events, newest first.
    - `ts` string
    - `sha12` string
    - `kind` string
    - `provider` string
    - `model` string
    - `api` string
    - `in` integer
    - `out` integer
    - `cost_uusd` integer: micro-USD
    - `status` integer
    - `ms` integer

## Other responses

- `401`: No auth.
- `403`: Not an operator / scope not authorized.

---

[API](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api.md) · [All operations](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api/revisions/be67c1f67c27?raw)