Penny Docs
Merchants

Delete Merchant

DELETE
/v1/households/{household_id}/merchants/{merchant_id}

Deletes a merchant and clears its assignment from all associated transactions, including transactions on deleted accounts. The transactions themselves are retained.

Also permanently removes the merchant's recurring series and dismissed recurring suggestions, and cleans up rules that reference it. Rules left without criteria or actions are deleted. 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
merchant_id*Merchant Id

Response Body

application/json

application/json

application/json

application/json

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