---
title: "List all households"
method: GET
path: "/v1/households"
tags: ["Households"]
---

# List all households

`GET /v1/households`

## Request

- Base URL: `https://api.givebutter.com`
- URL: `https://api.givebutter.com/v1/households`
- Auth: HTTP bearer

## Query parameters

- `headContactId` string, nullable
- `contacts` string, nullable
- `query` string, nullable
- `sortBy` string, nullable
- `sortByDesc` string, nullable
- `page` string

## Response `200`

Array of `HouseholdResource`

- HouseholdResource[]
  - `id` integer, required
  - `name` string, required
  - `head_contact_id` integer, nullable, required
  - `account_id` integer, required
  - `envelope_name` string, nullable, required
  - `note` string, nullable, required
  - `created_at` string, date-time, nullable, required
  - `updated_at` string, date-time, nullable, required
  - `contacts` object[]
    - `id` string, required
    - `account_id` string, required
    - `company_name` string, required
    - `first_name` string, required
    - `first_name_display` string, required
    - `last_name` string, required
    - `last_name_display` string, required
    - `middle_name` string, required
    - `name_display` string, required
    - `pronouns` string, required
    - `primary_email` string, required
    - `primary_phone` string, required
    - `type` string, required

## Other responses

- `422`: Validation error

## Changes

- **2026-11-03** `7793d61ca0da`: 2 info
  - added the required property `items/contacts/items/account_id` to the response with the `200` status
  - added the required property `items/contacts/items/pronouns` to the response with the `200` status

[Operation history](https://skmtc.dev/givebutter/apis/givebutter-api-documentation/changes/v1/households/get.md)

---

[API](https://skmtc.dev/givebutter/apis/givebutter-api-documentation.md) - [All operations](https://skmtc.dev/givebutter/apis/givebutter-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/givebutter/apis/givebutter-api-documentation/revisions/77b0b8449872?raw)