OrderSubscription
December 19, 2025 ยท View on GitHub
Fields
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
metadata | Dict[str, models.MetadataOutputType] | :heavy_check_mark: | N/A | |
created_at | date | :heavy_check_mark: | Creation timestamp of the object. | |
modified_at | date | :heavy_check_mark: | Last modification timestamp of the object. | |
id | str | :heavy_check_mark: | The ID of the object. | |
amount | int | :heavy_check_mark: | The amount of the subscription. | 10000 |
currency | str | :heavy_check_mark: | The currency of the subscription. | usd |
recurring_interval | models.SubscriptionRecurringInterval | :heavy_check_mark: | N/A | |
recurring_interval_count | int | :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. | |
status | models.SubscriptionStatus | :heavy_check_mark: | N/A | |
current_period_start | date | :heavy_check_mark: | The start timestamp of the current billing period. | |
current_period_end | date | :heavy_check_mark: | The end timestamp of the current billing period. | |
trial_start | date | :heavy_check_mark: | The start timestamp of the trial period, if any. | |
trial_end | date | :heavy_check_mark: | The end timestamp of the trial period, if any. | |
cancel_at_period_end | bool | :heavy_check_mark: | Whether the subscription will be canceled at the end of the current period. | |
canceled_at | date | :heavy_check_mark: | The timestamp when the subscription was canceled. The subscription might still be active if cancel_at_period_end is true. | |
started_at | date | :heavy_check_mark: | The timestamp when the subscription started. | |
ends_at | date | :heavy_check_mark: | The timestamp when the subscription will end. | |
ended_at | date | :heavy_check_mark: | The timestamp when the subscription ended. | |
customer_id | str | :heavy_check_mark: | The ID of the subscribed customer. | |
product_id | str | :heavy_check_mark: | The ID of the subscribed product. | |
discount_id | Nullable[str] | :heavy_check_mark: | The ID of the applied discount, if any. | |
checkout_id | Nullable[str] | :heavy_check_mark: | N/A | |
seats | OptionalNullable[int] | :heavy_minus_sign: | The number of seats for seat-based subscriptions. None for non-seat subscriptions. | |
customer_cancellation_reason | Nullable[models.CustomerCancellationReason] | :heavy_check_mark: | N/A | |
customer_cancellation_comment | Nullable[str] | :heavy_check_mark: | N/A |