Advanced Usage-Based Billing
For high-scale usage ingestion, use Advanced Usage-Based Billing with the Usage Events API. The Usage Events API supports schemaless event ingestion at scale, including individual events, batch ingestion, and usage file ingestion.
Creates a usage record for an item price in a subscription. The item price must belong to a metered item. This endpoint is part of the Usages API for Automated Metered Billing.
Max Usages
Legacy metered billing applies per-subscription usage limits over the subscription lifetime. Contact Support for the limit applicable to your site or to request an increase. For high-volume usage at scale, see Usage-Based Billing.
Sample Request
Sample Result[JSON]
URL Format
Input Parameters
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 .