---
title: "Get My Usage"
method: GET
path: "/api/v1/usage/me"
tags: ["Usage & Quota"]
---

# Get My Usage

`GET /api/v1/usage/me`

## 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/me`
- Auth: none declared

Return current user's aggregate usage + quota for the current billing month.

Uses existing `APIUsageHourly.call_count` aggregation (no new tables required for Phase 1).
Task telemetry is retained for dashboard visibility but does not gate monthly quota.

## Headers

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

## Response `200`

Successful Response

- UsageMeResponse: Response for GET /api/v1/usage/me — current user's aggregate usage.
  - `user_id` string, required: User ID
  - `tier` string, required: Current account tier
  - `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)
  - `task_telemetry` object: Task analytics (informational, not a monthly quota gate)
  - `calls` object, required: Call quota usage and percentage
  - `keys` KeyUsageSummary[]: Per-key breakdown
    - `key_id` string, required: API key ID (UUID)
    - `prefix` string, required: Key prefix (first 8 chars visible)
    - `tasks` integer, required: Tasks processed by this key this month
    - `calls` integer, required: API calls made by this key this month
    - `last_used` string, date-time, nullable: Last usage timestamp
  - `warnings` object[]: Quota warning objects (70%/90% thresholds)

## 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)