---
title: "Per-key usage statistics"
method: GET
path: "/v5/usage"
---

# Per-key usage statistics

`GET /v5/usage`

## Request

- Base URL: `https://headlessoracle.com`
- URL: `https://headlessoracle.com/v5/usage`
- Auth: API key in header `X-Oracle-Key`

Returns today/month request counts, free tier limits, credit balance, and upgrade info for the authenticated key. Requires X-Oracle-Key header. Paid keys return null limits and 0 usage counts.

## Response `200`

Usage statistics for the calling key

- object
  - `key_prefix` string
  - `plan` string
  - `requests_today` integer
  - `requests_this_month` integer
  - `daily_limit` integer, nullable
  - `monthly_limit` integer, nullable
  - `percent_used_today` number
  - `percent_used_month` number
  - `rate_limit_resets_at` string, date-time
  - `upgrade_url` string, uri
  - `x402_available` boolean
  - `x402_amount` string
  - `credit_balance` integer

## Other responses

- `401`: Missing API key
- `403`: Invalid API key

---

[API](https://skmtc.dev/headlessoracle/apis/headless-oracle.md) · [All operations](https://skmtc.dev/headlessoracle/apis/headless-oracle/llms.txt) · [OpenAPI document](https://skmtc.dev/headlessoracle/apis/headless-oracle/revisions/4e82fe332f29?raw)