---
title: "Get usage"
method: GET
path: "/usage"
---

# Get usage

`GET /usage`

## Request

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

## Response `200`

Success.

- UsageResponse
  - `period` '1d' | '7d' | '30d', required
  - `total_requests` integer, required
  - `total_cost_cents` number, required
  - `total_cost` string, required
  - `daily` object[], required
    - `date` string, required
    - `requests` integer, required
    - `cost_cents` number, required
  - `by_model` object[], required
    - `model` string, required
    - `requests` integer, required
    - `cost_cents` number, required
    - `avg_latency_ms` number, required
  - `by_endpoint` object[], required
    - `endpoint` string, nullable, required
    - `requests` integer, required
  - `request_id` string, required

## Other responses

- `400`: Invalid or unsupported request parameter.
- `401`: Missing or invalid API key.
- `402`: Insufficient balance or project spend limit reached.
- `429`: Rate limit exceeded.
- `500`: Gateway error.

---

[API](https://skmtc.dev/ninjachat/apis/ninjachat-api.md) · [All operations](https://skmtc.dev/ninjachat/apis/ninjachat-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ninjachat/apis/ninjachat-api/revisions/fa7dfcbdcb03?raw)