---
title: "getPlaylists"
method: GET
path: "/households/{householdId}/playlists"
tags: ["playlists"]
---

# getPlaylists

`GET /households/{householdId}/playlists`

Use the getPlaylists command to get the list of Sonos playlists for a household. Playlists do not include pinned items (any non-playable containers pinned to My Sonos) or Sonos favorites. See the Save your favorites section in the Sonos user guide for details about My Sonos.

 Returns a playlistsList object, which is an array of playlist objects with a version number.

## Response `200`

See the x-muse-error-codes extension for a list of muse errors that generate this response

- PlaylistsList — No description available
  - `version` string, nullable — The new version string. Sonos updates this version whenever the Sonos playlists change for the household. Your app can then send a getPlaylists command to receive the new list of playlists.
  - `playlists` Playlist[], nullable — An array of playlist objects.
    - `id` string, required — An identifier for the playlist.
    - `name` string, required — A user-identifiable name.
    - `type` string, nullable — The type of list. This is “playlist”.
    - `trackCount` integer, nullable — The number of tracks in the playlist.

## Other responses

- `400` — See the x-muse-error-codes extension for a list of muse errors that generate this response
- `401` — See the x-muse-error-codes extension for a list of muse errors that generate this response
- `403` — See the x-muse-error-codes extension for a list of muse errors that generate this response
- `404` — See the x-muse-error-codes extension for a list of muse errors that generate this response
- `499` — See the x-muse-error-codes extension for a list of muse errors that generate this response
- `500` — See the x-muse-error-codes extension for a list of muse errors that generate this response
- `503` — See the x-muse-error-codes extension for a list of muse errors that generate this response

---

[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/revisions/243132628620/schema)