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. |