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

# Usage Record Object

> Objeto de uso registrado para um subscription item medido.

Um `subscription_item_usage_record` registra uma quantidade usada por um item
`metered`. No fechamento do período, a Chargefy agrega os registros conforme
`aggregate_usage` do item e cria a linha de invoice correspondente.

```json theme={}
{
  "id": "ur_123",
  "object": "subscription_item_usage_record",
  "action": "increment",
  "created_at": "2026-05-20T12:00:00Z",
  "livemode": true,
  "metadata": {},
  "period_end": "2026-06-19T18:00:00Z",
  "period_start": "2026-05-19T18:00:00Z",
  "quantity": 42,
  "subscription": "sub_123",
  "subscription_item": "si_123",
  "timestamp": "2026-05-20T12:00:00Z",
  "updated_at": null
}
```

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

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

<ResponseField name="action" type="string">
  `increment` soma a quantidade ao acumulado; `set` substitui o acumulado no
  ponto do registro.
</ResponseField>

<ResponseField name="quantity" type="integer">
  Quantidade registrada.
</ResponseField>

<ResponseField name="subscription_item" type="string">
  Item medido (`si_*`) que recebeu o uso.
</ResponseField>

<ResponseField name="timestamp" type="string">
  Momento do uso em ISO 8601.
</ResponseField>