Link Search Menu Expand Document

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
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 77.4-49290 2024-02-13T15:56:06.184Z
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 One (S18) S2 77.4-49290 2024-02-13T15:55:36.464Z
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 77.4-49290 2024-02-13T15:55:24.423Z
Sonos One SL (S38) S2 72.2-40060 2023-05-22T16:39:25.503Z
Sonos Play:5 (S6) S2 64.3-19080 2021-08-18T06:06:35.970Z
Sonos Playbar (S9) S2 77.4-49290 2024-02-13T15:55:46.307Z
Sonos Sub (Sub) S2 63.2-90210 2021-07-21T23:31:40.304Z