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

# Get usage statistics

`GET /v1/usage`

## Request

- Base URL: `https://api.lithtrix.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.lithtrix.ai/v1/usage`
- Auth: none declared

Monthly call count, remaining quota, and a seven-day UTC daily breakdown from `usage_logs`.

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- UsageStatsResponse: Aggregated usage for ``GET /v1/usage``.
  - `calls_this_month` integer, required
  - `calls_remaining` integer, required
  - `monthly_limit` integer, required
  - `daily_breakdown` DailyBreakdownItem[], required
    - `date` string, required
    - `calls` integer, required

## Other responses

- `422`: Validation Error

---

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