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

# Get usage

`GET /v1/usage`

## Request

- Base URL: `https://api.hotapi.ai`
- URL: `https://api.hotapi.ai/v1/usage`
- Auth: HTTP bearer

Usage rollups (request count, credits charged, error count) for the organization, most recent first. Rollups are bucketed monthly: `date` is the month's first day (YYYY-MM-01). Optionally filter by a from/to date range; each bound applies independently.

## Query parameters

- `from` string
- `to` string

## Response `200`

Daily usage rollups, most recent first.

- UsageList: Daily usage rollups, most recent first.
  - `data` object[], required
    - `date` string, required: Calendar day (YYYY-MM-DD).
    - `model` string, required
    - `request_count` integer, required
    - `credits_charged` integer, required: Credits charged that day for this model.
    - `error_count` integer, required

## Other responses

- `400`: Standard error envelope returned by every error response (OpenAI-style).
- `401`: Standard error envelope returned by every error response (OpenAI-style).
- `429`: Standard error envelope returned by every error response (OpenAI-style).

---

[API](https://skmtc.dev/hotapi/apis/hotapi-gateway.md) · [All operations](https://skmtc.dev/hotapi/apis/hotapi-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/hotapi/apis/hotapi-gateway/revisions/9b6578b0c389?raw)