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

# Get Usage Stats

`GET /api/v1/usage/stats`

Get daily usage statistics for the API key's organization.

Returns paginated daily usage statistics with optional filtering by date range,
model, provider, and source. Each record represents aggregated usage for a specific
user/model/provider/source combination on a given date.

## Query parameters

- `start_date` string, date-time
- `end_date` string, date-time
- `model` string
- `model_provider` string
- `source` string
- `limit` integer — Number of records to return
- `offset` integer — Number of records to skip

## Response `200`

Successful Response

- UsageStatsResponse[]
  - `id` string, uuid, required
  - `user_id` string, uuid, required
  - `org_id` string, uuid, required
  - `email` string, required
  - `model` string, required
  - `source` string, required
  - `input_tokens` integer, required
  - `output_tokens` integer, required
  - `total_tokens` integer, required
  - `total_requests` integer, required
  - `date` string, date-time, required
  - `created_at` string, date-time, required

## Other responses

- `401` — Authentication Fails
- `422` — Invalid Parameters
- `500` — Server Error

---

[API](https://skmtc.dev/arcee/apis/arcee-chat-completions-api.md) · [All operations](https://skmtc.dev/arcee/apis/arcee-chat-completions-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/arcee/arcee-chat-completions-api/revisions/66e6d99d47bc/schema)