Skip to main content

GetUsage retrieves subscription usage summary for a date range.

GET 
/api/v1/billing/subscription/usage

Returns aggregated usage data for all metered resources (call minutes, SMS, storage, etc.) within the specified date range. Defaults to current billing period if dates not specified.

Authorization​

Requires billing:read permission.

Response​

Returns UsageSummary with:

  • Per-metric breakdown (quantity, included, overage, cost)
  • Total amount for all usage
  • Period start/end dates

Errors​

  • NOT_FOUND: No subscription exists
  • INVALID_ARGUMENT: Invalid date range (end before start)
  • PERMISSION_DENIED: Caller lacks billing:read permission

Request​

Responses​

A successful response.