---
title: "Deactivate a billing meter"
method: POST
path: "/v1/billing/meters/{id}/deactivate"
---

# Deactivate a billing meter

`POST /v1/billing/meters/{id}/deactivate`

When a meter is deactivated, no more meter events will be accepted for this meter. You can’t attach a deactivated meter to a price.

## Path parameters

- `id` string, required

## Response `200`

Successful response.

- BillingMeter — Meters specify how to aggregate meter events over a billing period. Meter events represent the actions that customers take in your system. Meters attach to prices and form the basis of the bill. Related guide: [Usage based billing](https://docs.stripe.com/billing/subscriptions/usage-based)
  - `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.

## Other responses

- `default` — Error response.

---

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