Stripe | Financial Infrastructure to Grow Your Revenue

Stripe | Financial Infrastructure to Grow Your Revenue

4466 articles

List billing meter event summaries


List billing meter event summaries

GET / v1 / billing / meters /:id / event_summaries

Retrieve a list of billing meter event summaries.

Parameters

  • customer string Required The customer for which to fetch event summaries.
  • end _ time timestamp Required The timestamp from when to stop aggregating meter events (exclusive). Must be aligned with minute boundaries.
  • id string Required Unique identifier for the object.
  • start _ time timestamp Required The timestamp from when to start aggregating meter events (inclusive). Must be aligned with minute boundaries.
  • value _ grouping _ window enum Specifies what granularity to use when generating event summaries. If not specified, a single event summary would be returned for the specified time range. For hourly granularity, start and end times must align with hour boundaries (e.g., 00:00, 01:00, …, 23:00). For daily granularity, start and end times must align with UTC day boundaries (00:00 UTC). Possible enum values day Generate event summaries per day. hour Generate event summaries per hour.

More parameters

  • ending _ before string
  • limit integer
  • starting _ after string

Returns

Returns a list of billing meter event summaries.

Response

Last verified 2026-09-24

Is this helpful?