---
title: "Get usage breakdown by request endpoint"
method: GET
path: "/admin/usage/endpoints"
tags: ["admin"]
---

# Get usage breakdown by request endpoint

`GET /admin/usage/endpoints`

## Request

- Base URL: `http://localhost:8080`
- URL: `http://localhost:8080/admin/usage/endpoints`
- Auth: HTTP bearer

Returns per-endpoint token and cost aggregates. Each row names
the operation its endpoint belongs to, so endpoints that mean
the same thing can be folded: /v1/chat/completions and
/v1/messages are both chat_completions.

## Query parameters

- `days` integer
- `start_date` string
- `end_date` string
- `model` string[]
- `provider` string[]
- `label` string[]
- `endpoint` string[]
- `operation` string
- `session_id` string
- `auth_key_id` string[]
- `user_path` string[]
- `cache_mode` string

## Response `200`

OK

- UsageEndpointUsage[]
  - `billed_cost` number, nullable
  - `cache_write_input_tokens` integer
  - `cached_input_cost` number, nullable
  - `cached_input_tokens` integer
  - `endpoint` string
  - `input_cost` number, nullable
  - `input_tokens` integer
  - `local_cached_input_tokens` integer
  - `local_cached_output_tokens` integer
  - `operation` string
  - `output_cost` number, nullable
  - `output_tokens` integer
  - `requests` integer
  - `total_cost` number, nullable
  - `total_tokens` integer
  - `uncached_input_tokens` integer

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden

## Changes

- **2026-10-26** `02fb28c7e1e3`: 6 info
  - for the `query` request parameter `auth_key_id`, the type was generalized from `string` to `array`
  - for the `query` request parameter `endpoint`, the type was generalized from `string` to `array`
  - for the `query` request parameter `label`, the type was generalized from `string` to `array`
  - for the `query` request parameter `model`, the type was generalized from `string` to `array`
  - …2 more
- **2026-10-26** `1dad923fde1a`: 1 info
  - added the optional property `items/billed_cost` to the response with the `200` status
- **2026-10-12** `505082b404f2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/enterpilot/apis/gomodel-api/changes/admin/usage/endpoints/get.md)

---

[API](https://skmtc.dev/enterpilot/apis/gomodel-api.md) - [All operations](https://skmtc.dev/enterpilot/apis/gomodel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/enterpilot/apis/gomodel-api/revisions/02d5643d7bec?raw)