---
title: "Get My Usage"
method: GET
path: "/user/usage"
tags: ["public"]
---

# Get My Usage

`GET /user/usage`

## Request

- Base URL: `https://cloud.onyx.app/api`
- URL: `https://cloud.onyx.app/api/user/usage`
- Auth: HTTP bearer

Caller's token/cost usage for the Usage tab.

## Query parameters

- `days` integer, nullable
- `start` string, date, nullable
- `end` string, date, nullable

## Response `200`

Successful Response

- UserUsageResponse
  - `per_day_by_model` UserUsageByDay[], required
    - `day` string, required
    - `model` string, required
    - `input_tokens` integer, required
    - `output_tokens` integer, required
    - `cache_read_tokens` integer, required
    - `cache_creation_tokens` integer, required
    - `cost_cents` number, required
  - `window_cost_cents` number, required
  - `budget_cents` number, nullable, required
  - `budget_remaining_cents` number, nullable, required
  - `budget_period_hours` integer, nullable
  - `budget_reset_at` string, date-time, nullable
  - `selected_model_price` ModelPrice, required
    - `model` string, required
    - `provider` string, nullable, required
    - `model_configuration_id` integer, nullable
    - `input_per_mtok` number, nullable, required
    - `output_per_mtok` number, nullable, required
    - `cache_per_mtok` number, nullable, required
    - `cache_write_per_mtok` number, nullable
  - `available_model_prices` ModelPrice[]
    - `model` string, required
    - `provider` string, nullable, required
    - `model_configuration_id` integer, nullable
    - `input_per_mtok` number, nullable, required
    - `output_per_mtok` number, nullable, required
    - `cache_per_mtok` number, nullable, required
    - `cache_write_per_mtok` number, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-28** `76bc90bf55b6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/onyx-dot-app/apis/onyx-api/changes/user/usage/get.md)

---

[API](https://skmtc.dev/onyx-dot-app/apis/onyx-api.md) - [All operations](https://skmtc.dev/onyx-dot-app/apis/onyx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/onyx-dot-app/apis/onyx-api/revisions/76bc90bf55b6?raw)