Usage

Get per-model breakdown

Returns per-model token/cost/carbon/energy rollups (with percentage share of total tokens) for the requested date range, optionally scoped to a project. Supply startDate + endDate (YYYY-MM-DD, together, max 366 days) for a custom period; they take precedence over range.

get/api/v1/usage/breakdown

Query parameters

range'7d' | '30d' | '90d' | '365d'

startDatestring

endDatestring

projectIdstring uuid

Response

Per-model breakdown

successtrue required

Changes

Changed in 1 of the 5 revisions of this API.11

Jul 26, 2026d602a00cf62e11See the full diff
- ▲
  the response property data/items/offsetCostUsd became nullable for the status 200
  response-property-became-nullable
- ○
  response property data/items/offsetCostUsd deprecated
  response-property-deprecated

Full history