Usage aggregates
One row per (day, endpoint): request volume, outcomes, billable units and credits charged.
Rows are ordered by date descending then endpoint. Minimum role: member.
Authorizations
Short-lived JWT issued by the CarHub auth service (Better Auth), verified against its
JWKS. Claims: sub (user), org_id (active organisation) and role
(owner | admin | member). Used by the dashboard for /mgmt/v1/… only — it is never
accepted on /v1/….
Query Parameters
Page size.
1 <= x <= 100Opaque cursor from the next_cursor of the previous page. Do not construct or parse it.
255First day of the reported period (inclusive, UTC). Defaults to 30 days ago.
Last day of the reported period (inclusive, UTC). Defaults to today.
Keep only rows for this endpoint, given as its dotted slug. Dotted slug of a CarHub endpoint, the identifier used for jobs and usage.
vehicle.analyse, vehicle.segment, vehicle.identify, vin.read, plate.read, document.read, dashboard.read, engine.detect, video.onboard, damage.detect, damage.severity, tire.read, tire.detect, parts.recognize, parts.segment, parts.decompose, pricing.vehicle, pricing.repair, render.background, render.enhance, render.plate, render.360, render.video, viewer.hotspots, inspections Keep only live (true) or test (false) records. Omitted, both are returned.
Response
A page of usage rows plus period totals.
Cursor pagination, used by every list in this API. Ask for the next page by passing
next_cursor back as cursor; stop when has_more is false. Cursors are opaque and
stable across inserts — never build one yourself.