> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chargefy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Subscription Item Object

> Objeto de item de uma subscription.

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

```json theme={}
{
  "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"
}
```

<ResponseField name="id" type="string">
  ID do item (`si_*`).
</ResponseField>

<ResponseField name="object" type="string">
  Sempre `subscription_item`.
</ResponseField>

<ResponseField name="subscription" type="string">
  Subscription dona do item.
</ResponseField>

<ResponseField name="aggregate_usage" type="string">
  Estratégia de agregação para item `metered`: `sum`, `last_during_period`,
  `last_ever` ou `max`.
</ResponseField>

<ResponseField name="discount" type="string | null">
  Desconto aplicado a este item recorrente.
</ResponseField>

<ResponseField name="price" type="string | null">
  Price de catálogo usado pelo item.
</ResponseField>

<ResponseField name="price_data" type="object | null">
  Snapshot de preço inline quando o item não usa um price de catálogo.
</ResponseField>

<ResponseField name="quantity" type="number">
  Quantidade recorrente.
</ResponseField>

<ResponseField name="recurring" type="object | null">
  Intervalo recorrente do item.
</ResponseField>

<ResponseField name="usage_type" type="string">
  `licensed` cobra a quantidade do item em todo ciclo. `metered` cobra os
  usage records acumulados no período.
</ResponseField>

<ResponseField name="usage_period_start" type="string | null">
  Início do período de uso atual para item `metered`.
</ResponseField>

<ResponseField name="usage_period_end" type="string | null">
  Fim do período de uso atual para item `metered`.
</ResponseField>