Skip to main content
GET
Credit ledger entries

Authorizations

Authorization
string
header
required

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

limit
integer
default:20

Page size.

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

Opaque cursor from the next_cursor of the previous page. Do not construct or parse it.

Maximum string length: 255
livemode
boolean

Keep only live (true) or test (false) records. Omitted, both are returned.

type
enum<string>

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.

Available options:
purchase,
subscription_grant,
reserve,
commit,
release,
refund,
adjustment,
test_grant
created_after
integer<int64>

Keep records created strictly after this epoch second.

created_before
integer<int64>

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.

data
object[]
required
has_more
boolean
required
next_cursor
string | null
required

Cursor of the next page, null on the last one.