curl -G https://api.tracklysms.com/api/v2/billing/records \
-H "X-Api-Key: trk_your_parent_key" \
--data-urlencode "updatedSince=2026-07-01T00:00:00Z" \
--data-urlencode "limit=200"
{
"records": [
{
"id": "66a0f7c84a1d4b2e9c3a1f2e",
"account_id": 1042,
"external_ids": { "location_id": "loc_west" },
"charge_type": "usage",
"trigger_reason": "monthly_billing",
"status": "succeeded",
"amount": 42.11,
"currency": "usd",
"messages_count": 9000,
"segments_count": 9300,
"refund_amount_total": 0.0,
"refunded_at": null,
"is_adjustment": false,
"period_start": "2026-06-01T00:00:00Z",
"period_end": "2026-07-01T00:00:00Z",
"created_at": "2026-07-01T00:12:00Z",
"updated_at": "2026-07-01T00:12:00Z"
}
],
"pagination": { "limit": 200, "has_more": false, "next_cursor": null }
}
Usage & Billing (v2)
List Billing Records
Individual charge and refund records, with cursor pagination and an updatedSince reconciliation watermark.
GET
/
v2
/
billing
/
records
curl -G https://api.tracklysms.com/api/v2/billing/records \
-H "X-Api-Key: trk_your_parent_key" \
--data-urlencode "updatedSince=2026-07-01T00:00:00Z" \
--data-urlencode "limit=200"
{
"records": [
{
"id": "66a0f7c84a1d4b2e9c3a1f2e",
"account_id": 1042,
"external_ids": { "location_id": "loc_west" },
"charge_type": "usage",
"trigger_reason": "monthly_billing",
"status": "succeeded",
"amount": 42.11,
"currency": "usd",
"messages_count": 9000,
"segments_count": 9300,
"refund_amount_total": 0.0,
"refunded_at": null,
"is_adjustment": false,
"period_start": "2026-06-01T00:00:00Z",
"period_end": "2026-07-01T00:00:00Z",
"created_at": "2026-07-01T00:12:00Z",
"updated_at": "2026-07-01T00:12:00Z"
}
],
"pagination": { "limit": 200, "has_more": false, "next_cursor": null }
}
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
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.
string
Currency.
integer
Messages covered.
integer
Segments covered.
number
Total refunded against this record.
string
When refunded, if applicable.
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.
object
limit, has_more, next_cursor.Examples
curl -G https://api.tracklysms.com/api/v2/billing/records \
-H "X-Api-Key: trk_your_parent_key" \
--data-urlencode "updatedSince=2026-07-01T00:00:00Z" \
--data-urlencode "limit=200"
{
"records": [
{
"id": "66a0f7c84a1d4b2e9c3a1f2e",
"account_id": 1042,
"external_ids": { "location_id": "loc_west" },
"charge_type": "usage",
"trigger_reason": "monthly_billing",
"status": "succeeded",
"amount": 42.11,
"currency": "usd",
"messages_count": 9000,
"segments_count": 9300,
"refund_amount_total": 0.0,
"refunded_at": null,
"is_adjustment": false,
"period_start": "2026-06-01T00:00:00Z",
"period_end": "2026-07-01T00:00:00Z",
"created_at": "2026-07-01T00:12:00Z",
"updated_at": "2026-07-01T00:12:00Z"
}
],
"pagination": { "limit": 200, "has_more": false, "next_cursor": null }
}
Error Codes
| HTTP Status | Error Code | Description |
|---|---|---|
| 400 | invalid_updated_since | updatedSince is not valid ISO-8601. |
| 400 | invalid_cursor | The pagination cursor is malformed. |
| 400 | invalid_child | childAccountId is malformed. |
| 404 | child_not_found | The childAccountId is not an owned child. |