---
title: "Which model fills each role, and this month's usage"
method: GET
path: "/api/v1/model-policy"
tags: ["model-gateway"]
---

# Which model fills each role, and this month's usage

`GET /api/v1/model-policy`

## Request

- Base URL: `https://worthune.com`
- URL: `https://worthune.com/api/v1/model-policy`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`

## Response `200`

The policy and usage.

- object
  - `ok` unknown, required
  - `roles` string[], required
  - `policy` ModelPolicyEntry[], required
    - `role` 'planner' | 'extractor' | 'narrator' | 'classifier', required
    - `model` string, required
    - `monthlyTokenBudget` integer, nullable, required
    - `key` ModelKey, required
      - `id` integer, required
      - `provider` 'anthropic' | 'gemini' | 'openai-compatible' | 'azure-openai', required
      - `label` string, required
      - `baseUrl` string, nullable, required
      - `hint` string, required: The key's last four characters. The key itself is never returned.
      - `createdAt` string, date-time, required
      - `lastUsedAt` string, date-time, nullable, required
    - `updatedAt` string, date-time, required
  - `usage` object, required
    - `month` string, required
    - `rows` object[], required
      - `role` string
      - `provider` string
      - `model` string
      - `calls` integer
      - `failures` integer
      - `inputTokens` integer
      - `outputTokens` integer

## Other responses

- `401`: No key presented (Authorization: Bearer wk_… or X-Api-Key).
- `402`: Unrecognized or revoked API key.
- `403`: The key predates organization support (contact support for a free rotation).
- `429`: Hourly per-org stateful quota, a per-route durable limit, or the 120 requests/minute per-IP burst backstop.
- `503`: Billing is not configured on this deployment; household resources are disabled rather than served without tenancy (production fail-closed).

---

[API](https://skmtc.dev/worthune/apis/worthune-api.md) · [All operations](https://skmtc.dev/worthune/apis/worthune-api/llms.txt) · [OpenAPI document](https://skmtc.dev/worthune/apis/worthune-api/revisions/9f2241072555?raw)