Penny Docs
Households

Get Household Members

GET
/v1/households/{household_id}/members

Lists the household's current members and pending invitations. Member records include their role and join date; invitation records include the invited role and expiration time.

Available to all household roles, including viewers, even when subscription access has lapsed.

Authorization

PersonalApiToken
AuthorizationBearer <token>

Use your personal API token (penny_pat_…) as the bearer credential. Enter the token only; the client adds the Bearer prefix. Read-only tokens permit read requests. Read/write tokens remain limited by your current household membership and role. See https://penny.finance/docs/api#authentication for setup.

In: header

Path Parameters

household_id*Household Id

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/households/string/members"
{  "members": [    {      "id": "Us2mH7qB5kLp",      "name": "Avery Chen",      "email": "user@example.com",      "role": "owner",      "image_url": "https://cdn.penny.finance/users/Us2mH7qB5kLp.png",      "joined_at": "2019-08-24T14:15:22Z"    }  ],  "invited": [    {      "id": "Iv8qM3cT6nRa",      "email": "user@example.com",      "role": "owner",      "invited_by_email": "user@example.com",      "expires_at": "2019-08-24T14:15:22Z"    }  ]}