Creates a usage record for an item price in a subscription. The item price must belong to a metered item.
Max Usages
The maximum number of usages that can be recorded for the entire lifetime of a subscription is 5000. Contact Support if you want this limit to be increased for your site.
Sample Request
URL Format
Input Parameters
A unique and immutable id for the usage. If not provided, it is autogenerated.
The id of the item price to which this usage belongs. The item price must be a part of the subscription or should have been part of it historically.
The time at which this usage occurred. Chargebee bills only those usages whose
usage_date
falls within a time when the subscription status
was active
or non_renewing.
However, the remaining usage records are still stored and are
retrievable.
Note:
If usage_date
corresponds to a time already invoiced, then it is stored but never invoiced unless the invoice is regenerated
.
A note for this usage record. This note is not displayed on any customer-facing document or interface such as invoice PDFs or Hosted Pages .
Returns
Resource object representing usage