Skip to main content
GET
/
api
/
v1
/
usage
List LLM usage for the current org (SPA-only)
curl --request GET \
  --url https://api.staging.getmodus.com/api/v1/usage \
  --header 'Authorization: Bearer <token>'
{
  "org_id": "<string>",
  "since": "<string>",
  "until": "<string>",
  "buckets": [
    {
      "bucket": "<string>",
      "model": "<string>",
      "call_count": 123,
      "input_tokens": 123,
      "output_tokens": 123
    }
  ],
  "totals": {
    "call_count": 123,
    "input_tokens": 123,
    "output_tokens": 123
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

since
string
required

ISO8601 start of the query window (inclusive).

Example:

"2026-05-01T00:00:00.000Z"

until
string
required

ISO8601 end of the query window (exclusive).

Example:

"2026-05-08T00:00:00.000Z"

rollup
enum<string>
required

Time bucket size for the response rows.

Available options:
hour,
day
Example:

"hour"

model
string

Narrow results to a single model (e.g. claude-3-7-sonnet).

Response

org_id
string
required

Clerk org id (org_xxx) the result is scoped to. Matches metering.usage_events.org_id. NOT the Postgres tenant UUID.

since
string
required
until
string
required
rollup
enum<string>
required
Available options:
hour,
day
buckets
object[]
required
totals
object
required