Get Billing Usage Summary
Billing
Billing Usage Summary
Returns a complete billing breakdown with usage counts and costs across all channels for a given date range.
GET
Get Billing Usage Summary
Date Handling
Bothstart_date and end_date accept two formats:
- Date only (
YYYY-MM-DD) —start_datedefaults to midnight UTC,end_datedefaults to 23:59:59 UTC. Simplest option when you want full-day UTC boundaries. - Full ISO timestamp (
YYYY-MM-DDTHH:mm:ssZ) — Exact UTC boundaries. Use this when you need timezone-specific alignment.
Timezone-Aligned Example
To query “February in US Eastern Time”, send:Notes
- RVM has two-part pricing: a per-drop fee plus a per-hour duration fee — both are included in
rvm.total_cost - All costs are in USD and rounded to 2 decimal places
Authorizations
Query Parameters
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 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
Object type identifier
Example:
"billing.usage_summary"
Your organization name
Ringless Voicemail — has two-part pricing (per-drop + per-hour duration)
Total cost across all channels in USD
Currency code
Example:
"usd"
