Get an item's billing terms
Returns the billing terms of one item: price, quantity, interval, trial, discount and a ready-to-show sentence. Secret, trusted and limited tokens may call it; a limited token only for the customer it is signed in as.
AuthorizationBearer <token>A secret, trusted or limited token. See Authentication.
subscription_id*stringThe subscription id.
item_id*stringThe item id. For a product item it is the product_id.
show?stringComma-separated fields to return; all others are left out. Use dot notation for child fields (customer.email). You cannot send show and hide together (400). See Customizing output.
hide?stringComma-separated fields to leave out of the response. Use dot notation for child fields (customer.email). You cannot send show and hide together (400). See Customizing output.
formatted?booleanWhen true, the object also has a formatted child with amounts and dates as display text in the shopper's language and currency (for example $19.99 or November 7, 2026). The default is false. See Localized formatting.
falseThe item's billing terms.
application/json- response
The billing terms of a subscription item: what is billed, how often, any trial and any discount. Also returned for a product or cart item before a subscription exists, so you can show the shopper what they sign up for.
object*"subscription_terms"The object type. Always subscription_terms.
"subscription_terms"price*numberThe price of one unit for each billing period, in currency.
quantity*numberHow many units are billed.
currency*stringThe three-letter ISO 4217 currency of price and discount.
discount*numberThe discount taken off each unit, in currency. 0 when none.
discount_price*|The unit price after the discount, in currency. null when there is no discount.
discount_apply_count*|How many billings the discount applies to. null means every billing.
discount_applied_count*integerHow many billings the discount has been applied to so far.
tax_inclusve*booleantrue when prices include tax for the customer's location. The field name is spelled this way in the API.
billing_interval*integerHow many billing_interval_unit make one billing period.
billing_interval_unit*stringThe unit of the billing period.
"minute""hour""day""month""year"billing_interval_description*stringThe billing period as text, for example 1 month or 3 months.
trial_interval*|The trial length in trial_interval_unit. null when there is no trial.
trial_interval_unit*|The unit of the trial. null when there is no trial.
"minute""hour""day""month""year"nulltrial_interval_description*|The trial length as text, for example 14 days. null when there is no trial.
date_trial_start*|When the trial starts or started. null when there is no trial.
date-timedate_trial_end*|When the trial ends or ended. null when there is no trial.
date-timeend_at_billing_count*|The number of billings after which billing stops. null means it bills until cancelled.
date_billing_start*stringWhen paid billing starts (the end of the trial, or the start date).
date-timesubscription_id*|The subscription these terms belong to. null before a subscription exists.
description*stringThe terms as one sentence in the customer's language, ready to show.
price_per_day*numberThe price worked out per day, in currency. For display only.
price_per_month*numberThe price worked out per month, in currency. For display only.
price_per_year*numberThe price worked out per year, in currency. For display only.
formatted?Display text for the prices and dates. Only returned with formatted=true.
curl -X GET 'https://api.comecero.com/api/v1/subscriptions/string/items/string/subscription_terms'{ "object": "subscription_terms", "price": 19.95, "quantity": 1, "currency": "USD", "discount": 0, "discount_price": null, "discount_apply_count": null, "discount_applied_count": 0, "tax_inclusve": false, "billing_interval": 1, "billing_interval_unit": "month", "billing_interval_description": "1 month", "trial_interval": null, "trial_interval_unit": null, "trial_interval_description": null, "date_trial_start": null, "date_trial_end": null, "end_at_billing_count": null, "date_billing_start": "2026-10-02T15:21:28Z", "subscription_id": "0093799318129SuLByRPW8", "description": "Acme Pro (monthly) is a subscription that renews every month with a payment of $19.95.", "price_per_day": 0.66, "price_per_month": 19.95, "price_per_year": 239.4}Preview an item change POST
Takes the same body as `POST /subscriptions/{subscription_id}/items/{item_id}` and returns what the change would cost and when it would apply, without charging or saving. A body with no change to quantity, price or discount answers `422`. Secret, trusted and limited tokens may call it, with the same rules as updating the item.
Undo an item's scheduled cancellation POST
Removes a cancellation of one item that was scheduled for the end of the current period, so the item keeps renewing. An item that is already cancelled cannot be uncancelled (`422`). The `subscription_item:cancellation_unscheduled` event fires. No body. Secret, trusted and limited tokens may call it. A limited token only for the customer it is signed in as, and only when your subscription settings allow customers to cancel (otherwise `403`).