---
title: "Read terminal occurrence volume by day"
method: GET
path: "/v1/usage"
---

# Read terminal occurrence volume by day

`GET /v1/usage`

## Request

- Base URL: `https://docs.greatwait.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.greatwait.dev/v1/usage`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer and API key in header `Greatwait-Environment` and API key in header `Greatwait-Project`

Legacy terminal-occurrence volume by UTC day from the authoritative scheduling model. This is an operational outcome aggregate retained for compatibility; it is not the PAYG invoice meter. Billing is per logical delivery attempt, including retries and redeliveries, and is exposed exactly by billing.summary and billing.ledger. Days with no terminal occurrence are absent rather than zero, and the window states which days the answer covers. `from` and `to` are snapped outward to UTC midnight, so an answer always covers whole days.

## Query parameters

- `bucketSeconds` integer
- `from` string
- `to` string

## Response `200`

Read terminal occurrence volume by day

- object
  - `bucketSeconds` integer, required
  - `days` object[], required
    - `billableOccurrences` integer, required
    - `byTerminalState` object, required
    - `start` string, required
  - `freshness` object, required
    - `kind` 'authoritative', required
  - `plan` object
    - `attemptsToday` integer, required
    - `dailyAttemptCeiling` integer, required
    - `resetsAt` string, required
    - `since` string, required
  - `totalBillableOccurrences` integer, required
  - `window` object, required
    - `from` string, required
    - `to` string, required

## Other responses

- `400`: Problem document. Possible codes at this status: invalid_request.
- `401`: Problem document. Possible codes at this status: authentication_required, credential_expired, credential_revoked.
- `403`: Problem document. Possible codes at this status: scope_missing.
- `409`: Problem document. Possible codes at this status: project_archived.
- `429`: Problem document. Possible codes at this status: rate_limited.
- `503`: Problem document. Possible codes at this status: capability_not_configured, service_unavailable.

---

[API](https://skmtc.dev/greatwait/apis/greatwait-v1.md) · [All operations](https://skmtc.dev/greatwait/apis/greatwait-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/greatwait/apis/greatwait-v1/revisions/6855bce23e72?raw)