---
title: "Get Billing Usage Summary"
method: GET
path: "/billing/usage-summary"
---

# Get Billing Usage Summary

`GET /billing/usage-summary`

Returns a complete billing breakdown with usage counts and costs across all channels for a given date range.

## Query parameters

- `start_date` string, required
- `end_date` string, required

## Response `200`

Usage summary retrieved successfully

- BillingUsageSummary
  - `object` string — Object type identifier
  - `organization` string — Your organization name
  - `period` object
    - `start_date` string — Start of the queried date range
    - `end_date` string — End of the queried date range
  - `sms` object
    - `count` number — Number of SMS segments sent
    - `cost` number — Total SMS cost
    - `unit_cost` number — Cost per segment
    - `unit` string — Unit type
  - `mms` object
    - `count` number — Number of MMS segments sent
    - `cost` number — Total MMS cost
    - `unit_cost` number — Cost per segment
    - `unit` string — Unit type
  - `email` object
    - `count` number — Number of emails sent
    - `cost` number — Total email cost
    - `unit_cost` number — Cost per message
    - `unit` string — Unit type
  - `rvm` object — Ringless Voicemail — has two-part pricing (per-drop + per-hour duration)
    - `drops` number — Number of voicemail drops
    - `drop_cost` number — Cost from drops (drops × drop rate)
    - `drop_unit_cost` number — Cost per drop
    - `duration_seconds` number — Total voicemail duration in seconds
    - `duration_hours` number — Total voicemail duration in hours
    - `duration_cost` number — Cost from duration (hours × hourly rate)
    - `duration_unit_cost_per_hour` number — Cost per hour of voicemail audio
    - `total_cost` number — Combined drop + duration cost
  - `calls_outbound` object
    - `minutes` number — Total outbound call minutes
    - `cost` number — Total cost
    - `unit_cost` number — Cost per minute
    - `unit` string — Unit type
  - `calls_inbound` object
    - `minutes` number — Total inbound call minutes
    - `cost` number — Total cost
    - `unit` string — Unit type
  - `total_cost` number — Total cost across all channels in USD
  - `currency` string — Currency code

## Other responses

- `400` — Invalid request — missing or invalid date parameters, or billing not configured
- `403` — Invalid API key or billing access not enabled
- `500` — Internal server error

---

[API](https://skmtc.net/collectwise/apis/collectwise-api.md) · [All operations](https://skmtc.net/collectwise/apis/collectwise-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/collectwise/collectwise-api/versions/a44939a1402b/schema)