Penny Docs
Households

Delete Household

DELETE
/v1/households/{household_id}

Permanently deletes the household and its associated financial data for every member. Only the household owner can delete it, including when subscription access has lapsed.

This operation cannot be undone. Request and download a data export first if you need to retain a copy. Returns 204 with no response body.

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

curl -X DELETE "https://example.com/v1/households/string"
Empty