Skip to main content
GET
Wallet balance + most recent billing rows

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit
integer
default:20

Number of recent billing rows to include (max 100).

Required range: 1 <= x <= 100
offset
integer
default:0

Skip this many rows before returning. Lets callers page.

Required range: x >= 0
teamId
string | null

If provided, return the team's wallet (requires membership).

Response

Successful Response

Snapshot of a wallet's balance + most recent billing rows.

Drives prime wallet. One call returns everything an agent needs to audit the billing flow against a known training run.

wallet_id
string
required
balance_usd
number
required

Current balance in USD

currency
string
required
total_billings
integer
required

Total billing rows on the wallet (across all pages)

recent_billings
BillingEntry · object[]
required
team_id
string | null