Skip to main content

GetSubscriptionEstimate returns estimated cost for the current billing period.

GET 
/api/v1/billing/subscription/estimate

Calculates the expected charge at the end of the billing period based on:

  • Plan base price
  • Current subscription items (seats, DIDs, etc.)
  • Storage overage (usage beyond plan's free limit)

What's NOT included​

  • Outbound call charges (billed real-time from wallet)
  • Usage already invoiced

Authorization​

Requires billing:subscriptions_read permission.

Response​

Returns estimated costs broken down by:

  • Plan cost
  • Subscription items cost (with itemized breakdown)
  • Storage overage cost
  • Tax and totals

Errors​

  • NOT_FOUND: Organization has no subscription
  • UNAUTHENTICATED: Missing or invalid authentication token
  • PERMISSION_DENIED: Caller lacks billing:subscriptions_read permission

Responses​

A successful response.