---
title: "The presented key's usage (30 days)"
method: GET
path: "/api/v1/usage"
tags: ["usage"]
---

# The presented key's usage (30 days)

`GET /api/v1/usage`

## Request

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

Daily aggregates of authenticated calls per endpoint for exactly the key you present, plus the household meter when the key belongs to an organization. Keyless sample traffic is not metered.

## Response `200`

Usage rows and totals (cache-control: private, no-store).

- object
  - `ok` unknown, required
  - `keyPrefix` string, required
  - `planId` string, required
  - `status` string, required
  - `days` unknown, required
  - `totals` object, required
    - `hits` integer, required
    - `errors` integer, required
  - `households` HouseholdMeterReport
    - `month` string, required: ISO month, e.g. "2026-08".
    - `activeHouseholds` integer, required
    - `includedActiveHouseholds` integer, nullable, required
    - `overage` integer, nullable, required: max(0, active − included); null when the plan is unknown.
    - `note` string, required
  - `mandates` MandateMeterReport: The active-mandate meter (Lodestar), in report mode: counted, not billed.
    - `month` string, required: UTC month, e.g. 2026-10.
    - `activeMandates` integer, required: Household mandates whose cycle worked their household this month. Proposals, triggers and approvals are free.
    - `bookLicenses` integer, required: Book mandates (rules-change) that ran this month; their swept households count on the household meter.
    - `planner` object, required: The planner role's model calls this UTC month. The tokens are your own cost with your provider; not billed by Worthune.
      - `calls` integer, required
      - `inputTokens` integer, required
      - `outputTokens` integer, required
    - `note` string, required
  - `rows` object[], required
    - `day` string, date, required
    - `name` string, required
    - `hits` integer, required
    - `errors` integer, required
  - `note` string, required

## Other responses

- `401`: No key presented (Authorization: Bearer wk_… or X-Api-Key).
- `402`: Unrecognized or revoked API key.
- `429`: Hourly per-org stateful quota, a per-route durable limit, or the 120 requests/minute per-IP burst backstop.

---

[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)