---
title: "Get usage report"
method: GET
path: "/api/v1/usage"
tags: ["usage"]
---

# Get usage report

`GET /api/v1/usage`

## Query parameters

- `from` string
- `to` string

## Response `200`

UsageReport

- UsageReport
  - `from` string, required
  - `to` string, required
  - `totals` UsageDollars, required
    - `llmDollars` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
      - 'Infinity' | '-Infinity' | 'NaN'
    - `vmDollars` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
      - 'Infinity' | '-Infinity' | 'NaN'
    - `totalDollars` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
      - 'Infinity' | '-Infinity' | 'NaN'
  - `tokens` UsageTokenTotals, required
    - `inputTokens` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
      - 'Infinity' | '-Infinity' | 'NaN'
    - `outputTokens` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
      - 'Infinity' | '-Infinity' | 'NaN'
    - `cacheReadTokens` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
      - 'Infinity' | '-Infinity' | 'NaN'
    - `cacheWriteTokens` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
      - 'Infinity' | '-Infinity' | 'NaN'
  - `members` UsageMemberDollars[], required
    - `principalUserId` string, nullable, required
    - `llmDollars` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
      - 'Infinity' | '-Infinity' | 'NaN'
    - `vmDollars` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
      - 'Infinity' | '-Infinity' | 'NaN'
    - `totalDollars` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
      - 'Infinity' | '-Infinity' | 'NaN'
  - `models` UsageModelDollars[], required
    - `model` string, required
    - `label` string, required
    - `dollars` union, required
      - number
      - 'NaN'
      - 'Infinity'
      - '-Infinity'
      - 'Infinity' | '-Infinity' | 'NaN'
    - `unbilled` boolean, required
    - `tokens` UsageTokenTotals, required
      - `inputTokens` union, required
        - number
        - 'NaN'
        - 'Infinity'
        - '-Infinity'
        - 'Infinity' | '-Infinity' | 'NaN'
      - `outputTokens` union, required
        - number
        - 'NaN'
        - 'Infinity'
        - '-Infinity'
        - 'Infinity' | '-Infinity' | 'NaN'
      - `cacheReadTokens` union, required
        - number
        - 'NaN'
        - 'Infinity'
        - '-Infinity'
        - 'Infinity' | '-Infinity' | 'NaN'
      - `cacheWriteTokens` union, required
        - number
        - 'NaN'
        - 'Infinity'
        - '-Infinity'
        - 'Infinity' | '-Infinity' | 'NaN'

## Other responses

- `400` — capy/InvalidRequest
- `401` — capy/Unauthorized

## Changes

- **2026-08-11** `792c11dd1007` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/capy/apis/capy-api/changes/api/v1/usage/get.md)

---

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