Skip to main content
curl -X POST "https://api.chargefy.io/v1/subscription-item-usage-records" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "quantity": 42,
    "subscription_item": "si_123"
  }'

{
  "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
}
Cria um usage record para um subscription_item com usage_type: "metered". O timestamp deve estar dentro do período atual de uso do item.
​
subscription_item
string
required
Item medido (si_*).
​
quantity
integer
required
Quantidade de uso.
​
action
string
increment ou set. Padrão: increment.
​
timestamp
string
Timestamp ISO 8601 ou Unix seconds. Padrão: agora.
​
metadata
object
Metadata livre.
curl -X POST "https://api.chargefy.io/v1/subscription-item-usage-records" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "quantity": 42,
    "subscription_item": "si_123"
  }'

{
  "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
}