v1
latestOpenAPI 3.0.1MIT2026-07-22241852.5 KBGet Billing Usage Summary
Returns a complete billing breakdown with usage counts and costs across all channels for a given date range.
get/billing/usage-summary
Query parameters
start_datestring required
Start of date range. Accepts YYYY-MM-DD (defaults to 00:00:00 UTC) or a full ISO 8601 UTC timestamp like 2025-02-01T05:00:00Z
end_datestring required
End of date range. Accepts YYYY-MM-DD (defaults to 23:59:59 UTC) or a full ISO 8601 UTC timestamp like 2025-02-28T04:59:59Z
Response
Usage summary retrieved successfully
Example response
{
"object": "billing.usage_summary",
"organization": "Acme Collections",
"period": {
"start_date": "2025-02-01",
"end_date": "2025-02-28"
},
"sms": {
"count": 185040,
"cost": 5551.2,
"unit_cost": 0.03,
"unit": "segments"
},
"mms": {
"count": 4000,
"cost": 120,
"unit_cost": 0.03,
"unit": "segments"
},
"email": {
"count": 15000,
"cost": 0,
"unit_cost": 0,
"unit": "messages"
},
"rvm": {
"drops": 50000,
"drop_cost": 700,
"drop_unit_cost": 0.014,
"duration_seconds": 150000,
"duration_hours": 41.67,
"duration_cost": 137.5,
"duration_unit_cost_per_hour": 3.3,
"total_cost": 837.5
},
"calls_outbound": {
"minutes": 10000,
"cost": 1080,
"unit_cost": 0.108,
"unit": "minutes"
},
"calls_inbound": {
"minutes": 5100,
"cost": 1190,
"unit": "minutes"
},
"total_cost": 8778.7,
"currency": "usd"
}