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.
Show billing record
string
Record ID.
integer
Owning account.
object
External IDs (e.g. location_id).
string
Type of charge (e.g. usage).
string
What produced the record (e.g. monthly_billing, carrier_trueup).
string
e.g. succeeded, refunded.
number
Charge amount, excluding any card processing fee. A programmable_voice record’s amount includes it.
string
Currency.
integer
Messages covered.
integer
Segments covered.
number
Total refunded against this record, excluding the card processing fee’s share of the refund, so it compares with amount. A programmable_voice record’s total includes it.
string
When the first refund was recorded, if any. A refund that only returned card processing fee charged above what the card owed also sets it, while refund_amount_total stays 0.
boolean
true for true-up / write-off adjustments.
string
Billing period start.
string
Billing period end.
string
Creation time.
string
Last-change time; the reconciliation watermark field.