This is a list of all public thin events we currently send for updates to MeteredItem, which are continually evolving and expanding. The payload of thin events is unversioned. During processing, you must fetch the versioned event from the API or fetch the resource’s current state.
Event types
Attributes
- idstring
Unique identifier for the event.
- objectstring, value is "v2.core.event"
String representing the object’s type. Objects of the same type share the same value of the object field.
- contextnullable string
Authentication context needed to fetch the event or related object.
- createdtimestamp
Time at which the object was created.
- livemodeboolean
Has the value
trueif the object exists in live mode or the valuefalseif the object exists in test mode. - reasonnullable object
Reason for the event.
- related_
objectnullable object Object containing the reference to API resource relevant to the event.
- typestring, value is "v2.billing.metered_item.created"
The type of the event.
Fetched attributes
- dataobject
Additional data about the event.
{ "created": "2025-01-01T00:00:00.000Z", "id": "evt_65SJYFLbcODkA5Zd7rZ16RuKJoESSQUtPVJKIgeI4D2BpA", "object": "v2.core.event", "type": "v2.billing.metered_item.created", "livemode": true, "reason": { "type": "request", "request": { "id": "req_65SJYFLbcODkA5Zd7rZ16RuKJoESSQUtPVJKIgeI4D2FpE", "idempotency_key": "idem_65SJYFLbcODkA5Zd7rZ16RuKJoESSQUtPVJKIgeI4D2GpH" } }, "related_object": { "id": "bli_61SJYFLbcODkA5Zd7rZ16RuKJoESSQUtPVJKIgeI4D2KpL", "type": "v2.billing.metered_item", "url": "/v2/billing/metered_items/bli_61SJYFLbcODkA5Zd7rZ16RuKJoESSQUtPVJKIgeI4D2KpL" }}{ "created": "2025-01-01T00:00:00.000Z", "id": "evt_65SJYFLbcODkA5Zd7rZ16RuKJoESSQUtPVJKIgeI4D2BpA", "object": "v2.core.event", "type": "v2.billing.metered_item.created", "livemode": true, "reason": { "type": "request", "request": { "id": "req_65SJYFLbcODkA5Zd7rZ16RuKJoESSQUtPVJKIgeI4D2FpE", "idempotency_key": "idem_65SJYFLbcODkA5Zd7rZ16RuKJoESSQUtPVJKIgeI4D2GpH" } }, "related_object": { "id": "bli_61SJYFLbcODkA5Zd7rZ16RuKJoESSQUtPVJKIgeI4D2KpL", "type": "v2.billing.metered_item", "url": "/v2/billing/metered_items/bli_61SJYFLbcODkA5Zd7rZ16RuKJoESSQUtPVJKIgeI4D2KpL" }, "data": {}}Attributes
- idstring
Unique identifier for the event.
- objectstring, value is "v2.core.event"
String representing the object’s type. Objects of the same type share the same value of the object field.
- contextnullable string
Authentication context needed to fetch the event or related object.
- createdtimestamp
Time at which the object was created.
- livemodeboolean
Has the value
trueif the object exists in live mode or the valuefalseif the object exists in test mode. - reasonnullable object
Reason for the event.
- related_
objectnullable object Object containing the reference to API resource relevant to the event.
- typestring, value is "v2.billing.metered_item.updated"
The type of the event.
Fetched attributes
- dataobject
Additional data about the event.
{ "created": "2025-01-01T00:00:00.000Z", "id": "evt_65SJhYZDkX1uJ5gsI1Z16RuKJoESSQUtPVJKIgeI4D20zW", "object": "v2.core.event", "type": "v2.billing.metered_item.updated", "livemode": true, "reason": { "type": "request", "request": { "id": "req_65SJhXZEhB4oQ0Csu16RuKJoESSQUtPVJKIgeI4D26Fi", "idempotency_key": "idem_65SJhWUFiC5pR1Dtv16RuKJoESSQUtPVJKIgeI4D27Gj" } }, "related_object": { "id": "bli_61SJhVUEbdTBR3Cns16RuKJoESSQUtPVJKIgeI4D25Mc", "type": "v2.billing.metered_item", "url": "/v2/billing/metered_items/bli_61SJhVUEbdTBR3Cns16RuKJoESSQUtPVJKIgeI4D25Mc" }}{ "created": "2025-01-01T00:00:00.000Z", "id": "evt_65SJhYZDkX1uJ5gsI1Z16RuKJoESSQUtPVJKIgeI4D20zW", "object": "v2.core.event", "type": "v2.billing.metered_item.updated", "livemode": true, "reason": { "type": "request", "request": { "id": "req_65SJhXZEhB4oQ0Csu16RuKJoESSQUtPVJKIgeI4D26Fi", "idempotency_key": "idem_65SJhWUFiC5pR1Dtv16RuKJoESSQUtPVJKIgeI4D27Gj" } }, "related_object": { "id": "bli_61SJhVUEbdTBR3Cns16RuKJoESSQUtPVJKIgeI4D25Mc", "type": "v2.billing.metered_item", "url": "/v2/billing/metered_items/bli_61SJhVUEbdTBR3Cns16RuKJoESSQUtPVJKIgeI4D25Mc" }, "data": {}}The Custom Pricing Unit object.
A LicensedItem represents any item that you bill customers for based on the subscribed quantity.
A ServiceAction represents a recurring, automated action that can be applied as part of a subscription.
Rate Cards v2
A RateCard describes usage-based pricing. To bill a customer using a RateCard, create a RateCardSubscription which links it to the corresponding Cadence.
- POST/