CustomerOrderSubscription

July 20, 2026 ยท View on GitHub

Fields

FieldTypeRequiredDescriptionExample
created_atdate:heavy_check_mark:Creation timestamp of the object.
modified_atdate:heavy_check_mark:Last modification timestamp of the object.
idstr:heavy_check_mark:The ID of the object.
amountint:heavy_check_mark:The amount of the subscription.10000
currencystr:heavy_check_mark:The currency of the subscription.usd
recurring_intervalmodels.RecurringInterval:heavy_check_mark:N/A
recurring_interval_countint:heavy_check_mark:Number of interval units of the subscription. If this is set to 1 the charge will happen every interval (e.g. every month), if set to 2 it will be every other month, and so on.
statusmodels.SubscriptionStatus:heavy_check_mark:N/A
current_period_startdate:heavy_check_mark:The start timestamp of the current billing period.
current_period_enddate:heavy_check_mark:The end timestamp of the current billing period.
current_meter_period_startdate:heavy_check_mark:The start timestamp of the current meter period, if the product has a meter cycle set. Metered credits are granted and overage is settled on this cadence.
current_meter_period_enddate:heavy_check_mark:The end timestamp of the current meter period, if the product has a meter cycle set. This is when credits next renew.
trial_startdate:heavy_check_mark:The start timestamp of the trial period, if any.
trial_enddate:heavy_check_mark:The end timestamp of the trial period, if any.
cancel_at_period_endbool:heavy_check_mark:Whether the subscription will be canceled at the end of the current period.
canceled_atdate:heavy_check_mark:The timestamp when the subscription was canceled. The subscription might still be active if cancel_at_period_end is true.
started_atdate:heavy_check_mark:The timestamp when the subscription started.
ends_atdate:heavy_check_mark:The timestamp when the subscription will end.
ended_atdate:heavy_check_mark:The timestamp when the subscription ended.
past_due_atdate:heavy_minus_sign:The timestamp when the subscription entered past_due status.
pause_at_period_endbool:heavy_check_mark:Whether the subscription will be paused at the end of the current period.
paused_atdate:heavy_check_mark:The timestamp when the subscription was paused.
resumes_atdate:heavy_check_mark:The timestamp when a paused subscription is scheduled to automatically resume, if set.
customer_idstr:heavy_check_mark:The ID of the subscribed customer.
product_idstr:heavy_check_mark:The ID of the subscribed product.
discount_idNullable[str]:heavy_check_mark:The ID of the applied discount, if any.
checkout_idNullable[str]:heavy_check_mark:N/A
seatsOptionalNullable[int]:heavy_minus_sign:The number of seats for seat-based subscriptions. None for non-seat subscriptions.
customer_cancellation_reasonNullable[models.CustomerCancellationReason]:heavy_check_mark:N/A
customer_cancellation_commentNullable[str]:heavy_check_mark:N/A