Skip to main content
GET
Usage history (daily or monthly)

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.

Query Parameters

granularity
enum<string>
Available options:
daily,
monthly
from
string<date-time>
to
string<date-time>
limit
integer
default:100
Required range: 1 <= x <= 500
offset
integer
default:0
Required range: x >= 0

Response

Usage history.

granularity
enum<string>
required
Available options:
daily,
monthly
from
string
required
to
string
required
items
object[]
required
metadata
object
required