## Get member household

`client.members.retrieveHousehold(stringmemberID, RequestOptionsoptions?): MemberRetrieveHouseholdResponse`

**get** `/v1/members/{member_id}/household`

Lists a member's household as a per-participant table — the account holder plus each active household member, with name, relationship, member type, date of birth, and household-admin flag. Access is scoped to the authenticated principal; a member not visible to the caller (or with no household) returns a 404.

### Parameters

- `memberID: string`

  Unique member identifier (mbr_*)

### Returns

- `MemberRetrieveHouseholdResponse`

  Unpaginated `{"data": [...]}` list of the members of a member's household.

  - `data: Array<Data>`

    - `date_of_birth: string`

      Date of birth (YYYY-MM-DD)

    - `first_name: string`

      Household member's first name

    - `household_admin_in: boolean`

      Whether this participant is a household admin (the account holder always is)

    - `last_name: string`

      Household member's last name

    - `member_id: string`

      Member identifier with 'mbr_' prefix

    - `member_type: "Account Holder" | "Dependent" | "Inactive"`

      * `Account Holder` - Account Holder
      * `Dependent` - Dependent
      * `Inactive` - Inactive

      - `"Account Holder"`

      - `"Dependent"`

      - `"Inactive"`

    - `relationship?: "Child" | "Spouse" | "Roommate" | "Other" | null`

      * `Child` - Child
      * `Spouse` - Spouse
      * `Roommate` - Roommate
      * `Other` - Other

      - `"Child"`

      - `"Spouse"`

      - `"Roommate"`

      - `"Other"`

### Example

```typescript
import VitableConnect from '@vitable-inc/vitable-connect';

const client = new VitableConnect({
  apiKey: process.env['VITABLE_CONNECT_API_KEY'], // This is the default and can be omitted
});

const response = await client.members.retrieveHousehold('mbr_abc123def456');

console.log(response.data);
```

#### Response

```json
{
  "data": [
    {
      "member_id": "mbr_abc123def456",
      "name": "Jane Doe",
      "relationship": null,
      "member_type": "Account Holder",
      "date_of_birth": "1990-04-12",
      "household_admin_in": true
    },
    {
      "member_id": "mbr_def456abc789",
      "name": "John Doe",
      "relationship": "Spouse",
      "member_type": "Household Dependent",
      "date_of_birth": "1989-02-03",
      "household_admin_in": false
    }
  ]
}
```