Delete subscription usage-based billing

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

This endpoint allows you to remove a usage-based billing product from a subscription. When deleting a subscription usage-based billing product, you must specify an unbilled usage strategy to determine how existing usage records will be handled.

Unbilled Usage Strategies

When deleting a subscription usage-based billing product, you must select one of the following unbilled usage strategies:

  1. write_off:

    • All reported usage records will be deleted.
    • These records will not be billed at the end of the current billing cycle.
  2. next_billing_cycle:

    • All reported usage records will be retained.
    • These records will be billed in the next billing cycle, even though the subscription usage-based billing product has been deleted.

Important Considerations

  • Choose the unbilled usage strategy carefully, as it directly affects how customers will be billed for their existing usage.
  • The write_off strategy may be suitable when you want to discontinue billing for a product immediately.
  • The next_billing_cycle strategy allows you to bill for existing usage one last time before discontinuing the product.

Related Endpoints

Path Params
string
required

Subscription handle

string
required

Usage-based billing handle

Query Params
string
required
length ≥ 1

Unbilled usage strategy

Responses

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json