Sonos Music API - Reference

This page is no longer updated.

See Error handling on the Sonos developer portal for the latest documentation.


Default Error Messages

The following table lists the error messages that will be presented to a Sonos user under different usage contexts. See error handling for details.

Error code

Message shown if fault happens during browse/search

Message shown if fault happens during account set-up

Message shown if fault happens during streaming

LoginInvalid

Unable to browse music - your %1$s login information is not valid.

N/A

Unable to play %1$s - the %2$s account login information is not valid.

LoginDisabled

N/A

N/A

N/A

LoginUnauthorized

Unable to browse music - your %1$s trial has expired.

N/A

Unable to play %1$s - your %2$s trial has expired.

 

Please upgrade your account with %2$s.

LoginUnsupported

Unable to browse music - your %1$s account has not been upgraded to a subscription account.

There was a problem adding this account.

 

To use this account with Sonos, you must first upgrade it with %1$s to become a full subscriber.

Unable to play %1$s - please upgrade your account with %2$s to become a full subscriber.

DeviceLimit

N/A

N/A

N/A

UnsupportedTerritory

N/A

N/A

N/A

SessionIdInvalid

Unable to browse music.  (Note we silently try to reauthenticate if this error comes up, and only fail if that reauth attempt fails.)

N/A

N/A

ItemNotFound

Unable to browse music.

-or-

There was a problem searching. Please try again.

N/A

N/A

Default error message

Unable to browse music.

The %1$s server did not recognize your login information.

 

Please make sure that your login (email address or username), and your password

are correct, and try again.

 

If the problem persists, please contact %2$s for help with your account.

Unable to play %1$s - the connection to %2$s was lost.