Metered Items

Metered Items are the principle components of a product. Any product can have any number of metered items that are billed.

Each metered item will be tied to a specific billable metric and will be charged on that billable metric. For more details on how billable metrics work, check out our Billable Metrics page.

Each Metered Item will have these fields:

Nickname The name to show on the invoice. If this isn't passed, this will default to the billable metric.
billable_metric_id The id of the billable metric to be measured
tier_mode The tiered mode. Details are below.
tiers The list of tiers for this billable metric. This is where you allocate how usage is tracked and charged.

You can set two different tier modes for the billable metric.

Tiered Mode	Description
Volume	As usage increases, and certain tiers are hit, the overall usage gets priced as an average of the last tier.
Graduated	Graduated pricing charges for the usage in each tier instead of applying a single price to all usage

Aggregation Type	Description
Sum	The default value (passed if you don’t specify the parameter). The total billed is based on the sum of all usage records for the billing period.
last_during_period	The total billed is based on the most recent usage record for the billing period. If no usage is reported for the billing period, the total billed is based on a usage quantity of 0.
last_ever	The total billed is based on the most recently provided usage record. If no usage is reported during the current billing period, Stripe looks for a previous usage record. If no usage record is found, the total billed is based on a usage quantity of 0.
max	The total billed is based on the usage record with the largest usage quantity for the billing period. If no usage is reported for the billing period, the total billed is based on a usage quantity of 0.