The Subscription Item object

A SubscriptionItem represents a single priced line in a subscription. Each item links a price to a quantity and determines what the customer is billed each period. A subscription must always contain at least one item.

{
  "id": "si_89abcdef0123",
  "object": "subscription_item",
  "price": {
    "currency": "CLP",
    "product": {
      "id": "prod_a7dkfnea",
      "object": "product",
      "created_at": "2025-08-01T00:00:00Z",
      "description": null,
      "image_url": null,
      "metadata": {},
      "mode": "live",
      "name": "Pro Plan"
    },
    "recurring": {
      "interval": "month",
      "interval_count": 1
    },
    "unit_amount": 15000
  },
  "quantity": 2
}

Attribute	Type	Description
`id`	string	Unique identifier for the subscription item.
`object`	string	String representing the object type. Always `"subscription_item"`.
`price`	object	Price configuration for this item.
`price.currency`	string	Three-letter ISO 4217 currency code.
`price.product`	object	Product associated with this price.
`price.product.id`	string	Unique identifier for the product.
`price.product.object`	string	String representing the object type. Always `"product"`.
`price.product.created_at`	string	ISO 8601 timestamp of when the product was created.
`price.product.description`	string	Description of the product. `null` if not set.
`price.product.image_url`	string	URL of an image for the product. `null` if not set.
`price.product.metadata`	object	Set of key-value pairs attached to the product.
`price.product.mode`	string	`"live"` or `"test"`.
`price.product.name`	string	Name of the product.
`price.recurring`	object	Recurrence configuration for this price.
`price.recurring.interval`	string	Billing interval. One of `"month"` or `"year"`.
`price.recurring.interval_count`	integer	Number of intervals between billings.
`price.unit_amount`	integer	Amount charged per unit in the smallest currency unit (for example, `15000` for $15,000 CLP).
`quantity`	integer	Number of units included in each billing period.