Subscription Item Object

Um subscription_item representa uma linha recorrente dentro de uma subscription. Uma subscription pode ter mais de um item, todos no mesmo ciclo recorrente.

{
  "id": "si_123",
  "object": "subscription_item",
  "aggregate_usage": "sum",
  "amount_discount": 0,
  "amount_subtotal": 30000,
  "amount_tax": 0,
  "amount_total": 30000,
  "created_at": "2026-05-19T18:00:00Z",
  "currency": "brl",
  "discount": null,
  "metadata": {},
  "position": 0,
  "price": "price_pro",
  "price_data": null,
  "product": "prod_123",
  "quantity": 3,
  "recurring": {
    "interval": "month",
    "interval_count": 1
  },
  "subscription": "sub_123",
  "unit_amount": 10000,
  "updated_at": "2026-05-19T18:10:00Z",
  "usage_period_end": null,
  "usage_period_start": null,
  "usage_type": "licensed"
}

string

ID do item (si_*).

object

string

Sempre subscription_item.

subscription

string

Subscription dona do item.

aggregate_usage

string

Estratégia de agregação para item metered: sum, last_during_period, last_ever ou max.

discount

string | null

Desconto aplicado a este item recorrente.

price

string | null

Price de catálogo usado pelo item.

price_data

object | null

Snapshot de preço inline quando o item não usa um price de catálogo.

quantity

number

Quantidade recorrente.

recurring

object | null

Intervalo recorrente do item.

usage_type

string

licensed cobra a quantidade do item em todo ciclo. metered cobra os usage records acumulados no período.

usage_period_start

string | null

Início do período de uso atual para item metered.

usage_period_end

string | null

Fim do período de uso atual para item metered.