---
title: "DEPRECATED alias of GET /api/credits/admin/usage"
method: GET
path: "/api/zai-keys/admin/usage"
tags: ["keys"]
deprecated: true
---

# DEPRECATED alias of GET /api/credits/admin/usage

`GET /api/zai-keys/admin/usage`

## Request

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

> **Deprecated.**

Deprecated 2026-09-15 (IC Credits rename); removed one release later. A thin re-export of GET /api/credits/admin/usage. Move to the new path.

## Response `200`

Same as GET /api/credits/admin/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)