Skip to main content
GET
Subject usage (current quota window plus bounded history)

Authorizations

Authorization
string
header
required

Clerk dashboard session JWT. Used on dashboard, billing, playground, and admin console routes only:

These are human-session credentials, not API keys. The dashboard frontend must never send authoritative account IDs, plan values, quota counters, Stripe IDs, or API-key actor fields — the server derives ownership from the session. Admin console routes additionally require the custom admin_role claim (admin or support) on the same verified session JWT; writes require admin.

Path Parameters

accountID
string
required

Query Parameters

granularity
enum<string>
default:daily
Available options:
daily,
monthly
days
integer
default:30
Required range: 1 <= x <= 366

Response

Current usage plus bounded history.

Reuses the dashboard usage shapes for the target account: current is the dashboard UsageSummaryResponse and history items are the same UsageHistoryItem buckets.

current
object
required
history
object[]
required