Price

A client-facing price for a product, Stripe-shaped: one number in minor units (or a tier list), never a formula. Optionally for one ensemble (the 10-piece’s reception price). Write-once once sold: retire with status and mint another.

billing_scheme
Type: "per_unit" or "tiered" or nullenum
required

per_unit: quantity × unit_amount. tiered: the tiers decide, in tiers_mode.
created_time
Type: stringFormat: date-time
read-only
required

the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
currency
Type: string | null
required

ISO 4217, lowercase.
ensemble_id
Type: string | nullFormat: uuid
required

The ensemble this price is for, when the product’s price depends on who plays it. Empty: the product’s price for any ensemble. References ensembles.id.
id
Type: stringFormat: uuid
read-only
required
label
Type: string | null
required

Internal nickname, e.g. "10-piece, 2027".
last_edited_time
Type: stringFormat: date-time
read-only
required

the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
lookup_key
Type: string | null
required

A stable handle, unique per band, e.g. "reception.10pc". For seeds, UI and sync.
order
Type: number | null
required
product_id
Type: string | nullFormat: uuid
required

References products.id.
status
Type: "active" or "inactive" or nullenum
required

Active prices are offered for new lines; inactive are retired. Lines already sold keep pointing at a retired price.
tiers
Type: object | null
required

When tiered: an array of {up_to, unit_amount, flat_amount}, ascending, the last with up_to null. Amounts in minor units. "$220 for the first 8, $27.50 each after" is [{up_to: 8, flat_amount: 22000}, {up_to: null, unit_amount: 2750}].

Properties: 1
tiers_mode
Type: "graduated" or "volume" or nullenum
required

graduated: each tier charges for the units that fall in it. volume: the tier the total quantity lands in prices every unit.
unit_amount
Type: number | null
required

Integer minor units (cents) per unit, when billing_scheme is per_unit.

TeamFilter

PriceInput