Skip to main content
Schema2020-08-27object

subscription_item

Subscription items allow you to create customer subscriptions with more than one plan, making it easy to represent complex billing relationships.

Source
openapi/spec3.json
Commit
d70de345383d
Active snapshot
da69df7e6e11

SubscriptionItem

object

Subscription items allow you to create customer subscriptions with more than one plan, making it easy to represent complex billing relationships.

billing_thresholds
optionalnullable

Define thresholds at which an invoice will be sent, and the related subscription advanced to a new billing period

created integer
required

Time at which the object was created. Measured in seconds since the Unix epoch.

id string
required

Unique identifier for the object.

metadata object
required

Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

object string
required

String representing the object's type. Objects of the same type share the same value.

price Price object
required

Prices define the unit cost, currency, and (optional) billing cycle for both recurring and one-time purchases of products. [Products](https://stripe.com/docs/api#products) help you track inventory or provisioning, and prices help you track payment terms. Different physical goods or levels of service should be represented by products, and pricing options should be represented by prices. This approach lets you change prices without having to change your provisioning scheme. For example, you might have a sing…

quantity integer
optional

The [quantity](https://stripe.com/docs/subscriptions/quantities) of the plan to which the customer should be subscribed.

subscription string
required

The `subscription` this `subscription_item` belongs to.

tax_rates array
optionalnullable

The tax rates which apply to this `subscription_item`. When set, the `default_tax_rates` on the subscription do not apply to this `subscription_item`.