---
title: "getHouseholds"
method: GET
path: "/households"
tags: ["households"]
---

# getHouseholds

`GET /households`

The getHouseholds command requests information on the households that can be acted upon,
 based upon the access token used when calling this API. There are no parameters for this command.

 If successful, Sonos responds with an array of household objects.

## Response `200`

This command returns a list of households.

- Households — This object contains a list of households.
  - `households` Household[], nullable — No description available
    - `id` string, required — This is the householdId, used in household targeted commands such as `getGroups`.
    - `name` string, nullable — This is a human friendly name assigned by Sonos or the user. Some user households might be unnamed, in which case this field is omitted from the response.
    - `swVersion` string, nullable — The max supported firmware version reported by devices connected with this household.
    - `ownerLuid` string, nullable — This is the luid (aka. sonosId, userId, id created by WWW db) of the account to which the players in the household are registered (i.e., the OWNER).

## Other responses

- `400` — The given resource/object identifier is invalid
- `401` — A client has not provided authorization credentials to perform a command
- `403` — A client does not have the correct permissions to perform a command
- `404` — A command was targeted to a group that no longer is the same group
- `499` — Indicates there was an error occurred when performing a command
- `500` — Sonos has experience an unexpected condition it is unable to recover from
- `503` — Player is unable to reach the service.

---

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