---
title: "getFavorites"
method: GET
path: "/households/{householdId}/favorites"
tags: ["favorites"]
---

# getFavorites

`GET /households/{householdId}/favorites`

Use the getFavorites command in the favorites namespace to get the list of Sonos favorites for a household. Favorites do not include pinned items (any non-playable containers pinned to My Sonos) or Sonos playlists. See the Save your favorites section in the Sonos user guide and Add favorites for details. The player limits the number of Sonos favorites to 70.
 An array of objects is returned such that a developer can implement the favorites picker from the Sonos controller.

## Response `200`

Returns a favoritesList object, which is an array of favorite objects with a version number.

 In the event of a failure, returns a globalError.

- FavoritesList — No description available
  - `version` string, required — This is the same version string used in the ETag Response Header.
  - `items` Favorite[], required — This is a homogeneous container of Favorite objects.
    - `id` string, required — An identifier for the favorite.
    - `name` string, required — A user-identifiable name.
    - `description` string, nullable — (Optional) Provides more context to the user.
    - `imageUrl` string, nullable — Replaced by the `images` parameter.
    - `service` Service — No description available
      - `name` string, nullable — No description available
      - `id` string, nullable — No description available
      - `imageUrl` string, nullable — Replaced by the `images` parameter.

## Other responses

- `400` — Returns a favoritesList object, which is an array of favorite objects with a version number. In the event of a failure, returns a globalError.
- `401` — Returns a favoritesList object, which is an array of favorite objects with a version number. In the event of a failure, returns a globalError.
- `403` — Returns a favoritesList object, which is an array of favorite objects with a version number. In the event of a failure, returns a globalError.
- `404` — Returns a favoritesList object, which is an array of favorite objects with a version number. In the event of a failure, returns a globalError.
- `499` — Returns a favoritesList object, which is an array of favorite objects with a version number. In the event of a failure, returns a globalError.
- `500` — Returns a favoritesList object, which is an array of favorite objects with a version number. In the event of a failure, returns a globalError.
- `503` — Returns a favoritesList object, which is an array of favorite objects with a version number. In the event of a failure, returns a globalError.

---

[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)