OrderSubscription

December 19, 2025 ยท View on GitHub

Fields

FieldTypeRequiredDescriptionExample
metadataDict[str, models.MetadataOutputType]:heavy_check_mark:N/A
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.SubscriptionRecurringInterval: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.
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.
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