---
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

- UsageReportEncoded
  - `from` string, required
  - `to` string, required
  - `totals` UsageDollarsEncoded, required
    - `llmDollars` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
    - `imageDollars` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
    - `vmDollars` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
    - `totalDollars` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
  - `tokens` UsageTokenTotalsEncoded, required
    - `inputTokens` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
    - `outputTokens` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
    - `cacheReadTokens` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
    - `cacheWriteTokens` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
  - `members` UsageMemberDollarsEncoded[], required
    - `principalUserId` string, nullable, required
    - `llmDollars` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
    - `imageDollars` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
    - `vmDollars` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
    - `totalDollars` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
  - `models` UsageModelDollarsEncoded[], required
    - `model` string, required
    - `label` string, required
    - `dollars` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
    - `unbilled` boolean, required
    - `tokens` UsageTokenTotalsEncoded, required
      - `inputTokens` union, required
        - number
        - 'Infinity' | '-Infinity' | 'NaN'
      - `outputTokens` union, required
        - number
        - 'Infinity' | '-Infinity' | 'NaN'
      - `cacheReadTokens` union, required
        - number
        - 'Infinity' | '-Infinity' | 'NaN'
      - `cacheWriteTokens` union, required
        - number
        - 'Infinity' | '-Infinity' | 'NaN'
  - `images` UsageImageDollarsEncoded[], required
    - `endpoint` string, required
    - `label` string, required
    - `dollars` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'

## Other responses

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

## Changes

> 12 revisions in range; 3 could not be searched.

- **2026-08-15** `3a998a0e7870` — 3 info
  - added the required property `images` to the response with the `200` status
  - added the required property `members/items/imageDollars` to the response with the `200` status
  - added the required property `totals/imageDollars` to the response with the `200` status
- **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/e9babb6783f3/schema)