---
title: "getVolume"
method: GET
path: "/players/{playerId}/playerVolume"
tags: ["playerVolume"]
---

# getVolume

`GET /players/{playerId}/playerVolume`

Use the getVolume command in the playerVolume namespace to get the volume and mute state of a player.

## Response `200`

Returns a playerVolume object type with the current volume, mute state, and fixed status of the targeted player.

- PlayerVolume — The playerVolume event in the playerVolume namespace indicates changes to the volume for a player, the mute state for the player and whether the player volume is fixed or can be changed. When your app subscribes to the playerVolume namespace and receives this event, it can update its user interface to reflect the latest player volume and player mute state. For example, if a user configures a CONNECT to have a fixed line-out volume, your app will receive a playerVolume event with the fixed parameter value of true. Your app should then disable its volume slider so users know that volume adjustments are not permitted.
  - `volume` integer, required — Indicates the volume of the player, between 0 and 100.
  - `muted` boolean — Indicates whether or not the player is muted. If true, the player is muted. If false, the player is not muted.
  - `fixed` boolean — Indicates whether or not the volume for the player is fixed or changeable. If true, your app cannot change the player volume. If false, your app can change the player volume. For example, the CONNECT has fixed-volume line-level output.

## Other responses

- `400` — The given resource/object identifier is invalid
- `401` — A client has not provided authorization credentials to perform a command
- `403` — A client does not have the correct permissions to perform a command
- `404` — A command was targeted to a group that no longer is the same group
- `499` — Indicates there was an error occurred when performing a command
- `500` — Sonos has experience an unexpected condition it is unable to recover from
- `503` — Player is unable to reach the service.

---

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