Credit ledger entries
The append-only credit ledger, newest first. The balance is the sum of these entries —
never a stored column. A job typically produces a reserve, then a commit and a
release for the unused delta. 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.
255Keep only live (true) or test (false) records. Omitted, both are returned.
Keep only ledger entries of this type.
Why credits moved. A successful job writes a reserve at admission, then a commit for
what it really cost and a release for the unused remainder.
purchase, subscription_grant, reserve, commit, release, refund, adjustment, test_grant Keep records created strictly after this epoch second.
Keep records created strictly before this epoch second.
Response
A page of ledger entries.
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.