Skip to main content
Manja / Stripe
Schema2020-08-27object

usage_record

Usage records allow you to report customer usage and metrics to Stripe for metered billing of subscription prices. Related guide: [Metered Billing](https://stripe.com/docs/billing/subscriptions/metered-billing).

Source
openapi/spec3.json
Commit
d70de345383d
Active snapshot
da69df7e6e11

UsageRecord

object

Usage records allow you to report customer usage and metrics to Stripe for metered billing of subscription prices. Related guide: [Metered Billing](https://stripe.com/docs/billing/subscriptions/metered-billing).

id string
required

Unique identifier for the object.

maxLength:5000

livemode boolean
required

Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.

object string
required

String representing the object's type. Objects of the same type share the same value.

Allowed: "usage_record"

quantity integer
required

The usage quantity for the specified date.

subscription_item string
required

The ID of the subscription item this usage record contains data for.

maxLength:5000

timestamp integer (unix-time)
required

The timestamp when this usage occurred.