---
title: "Key usage & quota"
method: GET
path: "/api/v1/usage"
tags: ["Meta"]
---

# Key usage & quota

`GET /api/v1/usage`

Usage introspection for the calling key's owner: the Data API plan, its monthly
limit, used and remaining (always matching the X-Quota-* headers), the current
period window, and per-endpoint / per-token breakdowns. Embed-widget usage has
its own plan and pool — it never appears here.

## Response `200`

- object
  - `data` object
    - `plan` string
    - `limit` integer
    - `used` integer
    - `remaining` integer
    - `period_start` string
    - `period_end` string
    - `burst_per_minute` integer
    - `endpoints` object[]
      - `endpoint` string
      - `requests` integer
    - `tokens` object[]
      - `id` integer
      - `name` string
      - `kind` string
      - `requests` integer
      - `last_used_at` string
      - `revoked` boolean
  - `meta` object
    - `note` string

---

[API](https://skmtc.net/bitculator/apis/bitculator-data-api.md) · [All operations](https://skmtc.net/bitculator/apis/bitculator-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitculator/bitculator-data-api/versions/ed1378af68b6/schema)