---
title: "Stop a specific version of a meter"
method: POST
path: "/meters/stop/{meterId}/{version}"
tags: ["Meters"]
---

# Stop a specific version of a meter

`POST /meters/stop/{meterId}/{version}`

Stops all runnable NORMAL-mode runs for a specific version of a meter in Zuora Mediation.

By default, the API gracefully stops streaming meters by creating a savepoint.
Streaming stops are asynchronous. A successful response means that the stop request
was accepted and triggered; the meter version might temporarily remain in the
STOPPING state before transitioning to PAUSED.

For batch meters and DEBUG runs, the job is canceled synchronously.

The caller must have at least one of the following permissions:
`RunMeters` or `ConfigureMetersAndEvents`.

Force Stop is not supported when a run is already in the `STOPPING` state. 
`STOPPING` is a temporary transition state while the system processes a graceful stop. 
In most cases, the run quickly either returns to `RUNNING` if the graceful stop cannot be 
completed, or moves to its final terminal state. If Force Stop is required, retry the operation 
after the run exits the `STOPPING` state.

## Path parameters

- `meterId` integer, required
- `version` string, required

## Query parameters

- `forceStop` boolean

## Headers

- `Content-Type` string
- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Track-Id` string

## Response `200`

Meter stop request accepted successfully.

- MediationStopMeterResponse
  - `success` boolean — Indicates whether the request was successful.
  - `error` object — Error details returned when the request fails.
    - `code` string — Machine-readable error code identifying the failure.
    - `message` string — Human-readable description of the error.

## Other responses

- `400` — Bad Request. The response error code can indicate one of the following conditions: - `70002103`: Meter does not exist. - `70002104`: Meter version does not exist. - `70003043`: A stop is already in progress for this meter version. - `70002122`: The meter version is not running.
- `500` — Internal Server Error.

## Changes

- **2026-08-08** `7f43d4a77e8a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/zuora/apis/api-reference/changes/meters/stop/:meterId/:version/post.md)

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)