Skip to main content
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.

Examples

Error Codes