1. Billing
  2. Ramps
  3. Ramp items to update

Ramp items to update

ramp_items_to_update
copy
Click to Copy
Details about the item prices associated with the subscription in the ramp.

Columns

No match found
ramp_id string, not null
Foreign Key ramps.id
A unique and immutable identifier for the ramp.
item_price_id string, not null
Foreign Key item_prices.id
The unique identifier of the item price.
amount long, null
The total amount for the item, calculated from unit_price, free_quantity, quantity, and item_tiers as applicable. The value depends on the currency type.
amount_in_decimal string, null
The decimal representation of the item's total amount, in major currency units. Returned when multi-decimal pricing is enabled.
billing_cycles null
For a plan-item price:
the number of billing cycles before the subscription ends automatically. If not specified, the value from item prices is used.

For addon-item prices:
if addon billing cycles are enabled, this is the number of billing cycles the addon applies. If not specified, the system uses the value from attached addons or addon-item price.
free_quantity null
The quantity of the item that is free. Only the quantity above this is billable. Same as item_price.free_quantity.
free_quantity_in_decimal string, null
The decimal representation of free_quantity as defined in the item price. Returned for quantity-based pricing when multi-decimal pricing is enabled.
item_type string, not null
The type of item. The list must contain exactly one item of type plan. Possible values are:
  • addon: Addon
  • charge: Charge
  • plan: Plan
metered_quantity string, null
The number of units recorded for this item during the current subscription term.
quantity null
The number of units of the item.
quantity_in_decimal string, null
The decimal representation of the item quantity. Available only for quantity-based pricing when multi-decimal pricing is enabled.
service_period_days null
The number of service days for the item, starting from the charge date.
unit_price long, null
The unit price of the item. If not provided, the system uses the value from item prices. Applicable when the pricing_model is flat_fee or per_unit, and only when price overriding is enabled. The value depends on the currency type.
unit_price_in_decimal string, null
The decimal representation of the item's unit price, in major currency units. Returned when multi-decimal pricing is enabled.