Sonos SOAP Services
Every sonos speaker has several soap services. Each service has one or more actions you can call.
UPNP specifications
Sonos speaker follow the MediaServer:4 and MediaRenderer:3 specifications by the Open Connectivity Foundation. These documents can provide you with some extra guidelines. More details can be found at Sonos communication, which show you how to exactly do a call to the sonos speakers.
All available services
| Service | Description |
|---|---|
| AlarmClock | Control the sonos alarms and times |
| AudioIn | Control line in |
| AVTransport | Service that controls stuff related to transport (play/pause/next/special URLs) |
| ConnectionManager | Services related to connections and protocols |
| ContentDirectory | Browse for local content |
| DeviceProperties | Modify device properties, like LED status and stereo pairs |
| GroupManagement | Services related to groups |
| GroupRenderingControl | Volume related controls for groups |
| HTControl | Service related to the TV remote control |
| MusicServices | Access to external music services, like Spotify or Youtube Music |
| QPlay | Services related to Chinese Tencent Qplay service |
| Queue | Modify and browse queues |
| RenderingControl | Volume related controls |
| SystemProperties | Manage system-wide settings, mainly account stuff |
| VirtualLineIn | Â |
| ZoneGroupTopology | Zone config stuff, eg getting all the configured sonos zones |
UPNP errors
These are the default UPNP errors.
| Error code | Description |
|---|---|
400 | Bad request |
401 | Invalid action |
402 | Invalid args |
404 | Invalid var |
412 | Precondition failed |
501 | Action failed |
600 | Argument value invalid |
601 | Argument value out of range |
602 | Optional action not implemented |
603 | Out of memory |
604 | Human intervention required |
605 | String argument too long |
606 | Action not authorized |
607 | Signature failure |
608 | Signature missing |
609 | Not encrypted |
610 | Invalid sequence |
611 | Invalid control URL |
612 | No such session |
This file is automatically generated with @svrooij/sonos-docs, do not edit manually.
| Device | Software generation | Software version | Discovery date |
|---|---|---|---|
Sonos Play:1 (S1) | S2 | 86.7-77050 | 2026-07-04T21:14:08.816Z |
Sonos One (S13) | S2 | 63.2-90210 | 2021-07-21T23:31:19.273Z |
Sonos Beam (S14) | S2 | 64.3-19080 | 2021-08-18T06:04:08.308Z |
Sonos Amp (S16) | S2 | 79.1-53290 | 2024-11-09T18:45:16.539Z |
Sonos Move (S17) | S2 | 93.1-73290 | 2026-02-09T06:10:26.755Z |
Sonos One (S18) | S2 | 95.0-77060 | 2026-07-04T21:13:16.939Z |
SYMFONISK Bookshelf (S21) | S2 | 66.4-23300 | 2022-01-01T11:41:01.361Z |
Sonos Roam (S27) | S2 | 63.2-90210 | 2021-07-21T23:31:31.207Z |
Sonos Play:3 (S3) | S2 | 64.3-19080 | 2021-08-18T06:09:36.692Z |
SYMFONISK Bookshelf (S33) | S2 | 95.0-77060 | 2026-07-04T21:14:02.212Z |
Sonos Ray (S36) | S2 | 95.0-77060 | 2026-07-04T21:13:47.351Z |
Sonos One SL (S38) | S2 | 95.0-77060 | 2026-07-04T21:16:52.734Z |
Sonos Era 100 (S39) | S2 | 79.1-53290 | 2024-11-09T18:45:10.792Z |
Sonos Play:5 (S6) | S2 | 86.4-73290 | 2026-02-09T06:10:32.747Z |
Sonos Playbar (S9) | S2 | 86.7-77050 | 2026-07-04T21:13:40.356Z |
Sonos Sub (Sub) | S2 | 63.2-90210 | 2021-07-21T23:31:40.304Z |