Usage & Billing (v2)
List Billing Records
Individual charge and refund records, with cursor pagination and an updatedSince reconciliation watermark.
GET
Returns individual billing records (charges, adjustments, refunds) for the caller and its children. Supports the same reconciliation pattern as messages — pass
updatedSince to pull only what changed.
Query Parameters
integer
Restrict to one owned child.
string
Filter by charge type (e.g.
usage).string
Filter by record status (e.g.
succeeded, refunded).string
Reconciliation watermark (ISO-8601). Returns records changed after this time, newest-first within the cursor.
string
Opaque pagination cursor from a previous response’s
next_cursor.integer
default:"50"
Page size, max 200.
Response Fields
array
Array of billing records.
object
limit, has_more, next_cursor.