Skip to main content
GET
List Ledger Entries
Returns the team’s credit transactions in reverse-chronological order. Every debit (image/video generation, render) and credit (monthly reset, refund, coupon claim, top-up) is a row. Useful for building a usage dashboard, reconciling end-of-month spend, or surfacing “why did my balance drop?” to the user. Scoped to the team selected by the caller’s session / API key. RLS already enforces team membership.

Query Parameters

string (ISO-8601)
Return rows strictly older than this timestamp. Use the created_at of the last row on the previous page as the cursor.

Response

200

Fields

integer
Signed credit change. Negative for spends, positive for grants / refunds / top-ups.
string
One of image_gen, video_gen, render, monthly_reset, initial_grant, plan_change_topup, refund, admin_grant, coupon_claim.
string | null
Model that incurred the debit, for generation rows. null for non-generation reasons.
integer | null
Monthly-plan balance immediately after this row was written.
string | null
api_key (agent / server-to-server), jwt (dashboard session), or null (system-issued row like monthly_reset).
boolean
true when more rows exist older than the last returned row. Page again with ?before=<last_created_at>.

Example

cURL