---
title: "Get billing usage"
method: GET
path: "/billing/usage"
tags: ["Billing"]
---

# Get billing usage

`GET /billing/usage`

Returns an organization's billing usage for a month as cost-annotated line items grouped into time windows. Finalized windows are returned through the end of yesterday at daily granularity, or the last completed hour at hourly granularity (UTC).

## Query parameters

- `month` string — Billing month in YYYY-MM format. Defaults to the current month, which returns data through yesterday (daily) or the last completed hour (hourly).
- `organization_id` string — Organization to report on. Usage is always reported for the organization that owns the API key, so this is optional; supplying an ID that is not that organization returns 403.
- `granularity` 'day' | 'hour' — Time window size for rows. 'hour' returns ~24x more rows than 'day'.
- `limit` integer — Maximum number of time windows per page (max 1000).
- `after` string — Opaque cursor from a previous response's `next_cursor`. Only valid for the month and granularity it was issued for. Current-month data is a moving snapshot: each page reflects data as of its request, so newly completed windows may appear at the end of the sequence.

## Response `200`

Billing usage report for the requested month

- BillingUsageReport
  - `object` 'list', required
  - `organization_id` string, required — ID of the organization the report belongs to.
  - `billing_period` string, required — Billing month (YYYY-MM).
  - `earliest_window_start` string, date-time, nullable, required — Start of the earliest time window with usage in the month (UTC, ISO 8601); null when the month has no usage.
  - `latest_window_end` string, date-time, nullable, required — Exclusive end of the latest time window with usage in the month (UTC, ISO 8601); null when the month has no usage. Describes the whole month, not the current page.
  - `currency` 'USD', required
  - `data` BillingUsageWindow[], required — Time windows containing usage line items.
    - `date` string, required — Day this window covers (UTC, YYYY-MM-DD). Present for both granularities.
    - `start_time` string, date-time, required — Window start (UTC, ISO 8601). Start of the day (daily) or hour (hourly).
    - `end_time` string, date-time, required — Window end (UTC, ISO 8601), exclusive. Start of the next day (daily) or hour (hourly).
    - `line_items` BillingUsageLineItem[], required — Usage line items in this time window.
      - `product_name` string, required — Metronome product name (e.g. 'Serverless Inference - Input Tokens').
      - `quantity` string, required — Total usage for the window in the product's native unit (GPU-hours, tokens, ...) as a decimal string.
      - `unit_price` string, required — Per-unit price in USD as a decimal string.
      - `cost` string, required — Total cost for this line item in USD as a decimal string.
      - `pricing_dimensions` object, required — Rate-determining dimensions (varies by product). Passthrough from Metronome pricing group values.
      - `attributes` object, required — Resource identifiers for attribution, varying by product.
  - `next_cursor` string, nullable, required — Opaque cursor for the next page; null when this is the last page.

## Other responses

- `400` — Invalid request parameters
- `401` — Unauthorized — missing or invalid API key
- `403` — Forbidden — organization_id does not match the organization that owns the API key
- `404` — Not found — the endpoint is not enabled for this organization
- `500` — Internal server error

## Changes

- **2026-08-27** `d8f688ad4165` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/together/apis/together-apis/changes/billing/usage/get.md)

---

[API](https://skmtc.dev/together/apis/together-apis.md) · [All operations](https://skmtc.dev/together/apis/together-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/together/together-apis/revisions/d8f688ad4165/schema)