Skip to main content
GET
Get the signed-in user's own per-turn µ spend (D5 per-user visibility)

Authorizations

Authorization
string
header
required

Supabase JWT token in Authorization: Bearer header

Query Parameters

days
enum<integer>
default:30

Lookback window in days. One of 7, 30, 90.

Available options:
7,
30,
90
limit
integer
default:50

Max turns per page (clamped to 200).

Required range: 1 <= x <= 200
cursor
string

Opaque keyset cursor from a prior response's next_cursor.

product
enum<string>

Optional product scope (sub-projects, contract C5). Omitted → today's response, unchanged. Usage events are not yet attributed to a product, so ANY valid product value returns 422 product_attribution_unavailable rather than silently returning unscoped data under a product label. An invalid value → 400 invalid_product. Applied AFTER auth/org/RBAC.

Available options:
research,
design,
develop,
operate,
canon,
unattributed,
all

Response

The user's own per-turn spend (estimated) for the window.

from
string<date-time>
required
to
string<date-time>
required
basis
enum<string>
required

Always rate_card_estimate — the µ figures are derived from token counts, not the settled ledger burn.

Available options:
rate_card_estimate
data
object[]
required
totals
object
required
next_cursor
string | null
required