---
title: "Company Llm Quota"
method: GET
path: "/companies/{company_id}/llm-quota"
tags: ["quotas"]
---

# Company Llm Quota

`GET /companies/{company_id}/llm-quota`

## Request

- Base URL: `https://app.zeno-works.ch` (the document declares no server; this is the origin it was published from)
- URL: `https://app.zeno-works.ch/companies/{company_id}/llm-quota`
- Auth: none declared

Whether this company's billing user has tokens available: `ok` or `exhausted`.

**Not the billing elevation.** `get_billing_scoped` calls `deny_company_scoped_key`
first, which 403'd a company-scoped key asking about **its own** company. The mcp
surface forwards exactly those keys, so the agent this read exists for would learn
about the limit only by being refused. `SystemScopedDep` reads the payer (who is very
often not a member of the company they pay for), and authorization is done here
explicitly: membership, then the key's own company binding, then the support session.

It answers a state and a reset instant and **never a magnitude**: a number lets a
company-scoped principal subtract its own consumption to obtain its siblings'
aggregate (programme invariant I8). With two states there is no threshold to search
between — `exhausted` cannot be withheld from someone who is being refused anyway.

## Path parameters

- `company_id` string, required

## Headers

- `authorization` string, nullable

## Cookies

- `access_token` string, nullable

## Response `200`

Successful Response

- CompanyQuotaOut: What a company may see about its billing user's token budgets. **`ok | exhausted` and a reset instant — never a magnitude.** PRE-02's confinement rule: a number lets a company-scoped principal subtract its own consumption from the payer's total to obtain its siblings' aggregate, and poll that into a live activity signal on a fiduciary's other clients (programme invariant I8). `purchased_balance` is a magnitude too — extra tokens are drawn by every company the payer pays for — so it is **null unless the viewer is the payer themself or an admin**, on an unconfined credential. Null means withheld, never "nothing bought".
  - `state` string, required
  - `resets_at` string, date-time, nullable
  - `purchased_balance` integer, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zeno-works/apis/zeno-api.md) · [All operations](https://skmtc.dev/zeno-works/apis/zeno-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zeno-works/apis/zeno-api/revisions/1eb93dde146c?raw)