List Usage Transactions

GET

/usage/transactions

• Production
• QA

Paginated credit-transaction ledger for the authenticated org (most recent first).

Supports both page-number pagination (page/limit) and opaque cursor pagination (cursor). When cursor is supplied it wins; the response always returns next_cursor for forward iteration.

Authorizations

• BearerAuth

Parameters

Query Parameters

page

Page number (ignored when cursor is supplied)

integer

default: 1 >= 1

Page number (ignored when cursor is supplied)

limit

Items per page

integer

default: 50 >= 1 <= 200

Items per page

cursor

Any of:

string

string

null

null

Opaque pagination cursor from a prior response’s next_cursor. When supplied it takes precedence over page.

Header Parameters

X-Target-Org-Id

Any of:

string

string

null

null

Responses

200

Successful Response

object

data

required

Array<object>

A single credit-ledger transaction.

object

amount

Credit delta (negative = spend)

number

created_at

Any of:

string

string

null

null

description

Any of:

string

string

null

null

id

Any of:

string

string

null

null

llm_tier

Any of:

string

string

null

null

quantity

Any of:

integer

integer

null

null

service

Any of:

string

string

null

null

type

Any of:

string

string

null

null

pagination

Any of:

PaginationMeta

object

has_next

required

Whether there are more pages

boolean

limit

required

Items per page

integer

next_cursor

Any of:

string

string

null

null

page

required

Current page number (1-indexed)

integer

total

required

Total number of items

integer

null

null

422

Validation Error

object

detail

Array<object>

object

loc

required

Array

msg

required

string

type

required

string