---
title: "List billing meters"
method: GET
path: "/v1/billing/meters"
---

# List billing meters

`GET /v1/billing/meters`

Retrieve a list of billing meters.

## Query parameters

- `ending_before` string
- `expand` string[]
- `limit` integer
- `starting_after` string
- `status` 'active' | 'inactive'

## Response `200`

Successful response.

- object
  - `data` BillingMeter[], required
    - `created` integer, required — Time at which the object was created. Measured in seconds since the Unix epoch.
    - `customer_mapping` BillingMeterResourceCustomerMappingSettings, required
      - `event_payload_key` string, required — The key in the meter event payload to use for mapping the event to a customer.
      - `type` 'by_id', required — The method for mapping a meter event to a customer.
    - `default_aggregation` BillingMeterResourceAggregationSettings, required
      - `formula` 'count' | 'last' | 'sum', required — Specifies how events are aggregated.
    - `display_name` string, required — The meter's name.
    - `event_name` string, required — The name of the meter event to record usage for. Corresponds with the `event_name` field on meter events.
    - `event_time_window` 'day' | 'hour', nullable — The time window which meter events have been pre-aggregated for, if any.
    - `id` string, required — Unique identifier for the object.
    - `livemode` boolean, required — If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
    - `object` 'billing.meter', required — String representing the object's type. Objects of the same type share the same value.
    - `status` 'active' | 'inactive', required — The meter's status.
    - `status_transitions` BillingMeterResourceBillingMeterStatusTransitions, required
      - `deactivated_at` integer, nullable — The time the meter was deactivated, if any. Measured in seconds since Unix epoch.
    - `updated` integer, required — Time at which the object was last updated. Measured in seconds since the Unix epoch.
    - `value_settings` BillingMeterResourceBillingMeterValue, required
      - `event_payload_key` string, required — The key in the meter event payload to use as the value for this meter.
  - `has_more` boolean, required — True if this list has another page of items after this one that can be fetched.
  - `object` 'list', required — String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
  - `url` string, required — The URL where this list can be accessed.

## Other responses

- `default` — Error response.

---

[API](https://skmtc.net/stripe/apis/spec3.md) · [All operations](https://skmtc.net/stripe/apis/spec3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stripe/spec3/revisions/3653ad45bbec/schema)