---
title: "Get Key Usage"
method: GET
path: "/api/v1/usage/keys/{key_id}"
tags: ["Usage & Quota"]
---

# Get Key Usage

`GET /api/v1/usage/keys/{key_id}`

## Request

- Base URL: `https://api.bellatorsi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.bellatorsi.com/api/v1/usage/keys/{key_id}`
- Auth: none declared

Return detailed usage for one API key owned by the authenticated user.

## Path parameters

- `key_id` string, required

## Headers

- `Authorization` string, nullable
- `x-api-key` string, nullable

## Response `200`

Successful Response

- UsageKeyDetailResponse: Detailed usage for a specific API key in the current month.
  - `key_id` string, required: API key UUID
  - `key_prefix` string, required: Visible key prefix
  - `period` UsagePeriod, required: Billing period window (UTC month boundaries).
    - `start` string, date-time, required: Period start (UTC)
    - `end` string, date-time, required: Period end (UTC)
  - `totals` object, required: Aggregated totals for the key
  - `endpoint_breakdown` KeyEndpointUsage[]
    - `endpoint` string, required: Endpoint path
    - `calls` integer, required: Calls for this endpoint
    - `tasks` integer, required: Tasks processed for this endpoint
    - `errors` integer, required: Error responses for this endpoint
    - `avg_response_ms` number, required: Average response time in ms
  - `hourly` KeyHourlyUsage[]
    - `hour` string, date-time, required: UTC hour bucket
    - `calls` integer, required
    - `tasks` integer, required
    - `errors` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/bellatorsi/apis/bellator-schedule-intelligence-apis.md) · [All operations](https://skmtc.dev/bellatorsi/apis/bellator-schedule-intelligence-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/bellatorsi/apis/bellator-schedule-intelligence-apis/revisions/03e7b786e43b?raw)