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

# Get usage

`GET /v4/billing/usage`

## Query parameters

- `unit` 'MS' | 'TOK'
- `fromInterval` string, required
- `toInterval` string, required
- `userId` union[], nullable
  - union
    - string, uuid
    - string

## Response `200`

Success

- SuccessResponseUsageReport
  - `success` true, required — Flag for it request was successful
  - `data` UsageReport, required
    - `rows` ReportRow[], required
      - `day` string, date, required — Usage date
      - `typ` string, nullable, required — Breakdown type category
      - `value` number, nullable, required — Usage value
  - `meta` ResponseMeta
    - `requestId` string — Unique request identifier for tracing
    - `timestamp` string, date-time — Response timestamp (UTC)
    - `durationMs` integer, nullable — Request processing time in milliseconds

## Other responses

- `401` — Auth Invalid Token
- `403` — Forbidden Insufficient Permissions
- `422` — Validation Failed
- `426` — Business Quota Exceeded
- `500` — Internal Error

---

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