Penny Docs
Recurring transactions

Restore Suggestion

POST
/v1/households/{household_id}/recurring-transactions/suggestions/restore

Reverses one recurring-suggestion dismissal identified by merchant, amount, currency, and frequency. The candidate may appear again if current transaction history still supports it.

Each request restores one dismissed series. Returns suggestion_not_found when there is no matching dismissal to reverse, or 204 with no response body on success.

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

Request Body

application/json

merchant_id*Merchant Id
amount*
frequency*RecurringFrequency

Value in

  • "every_week"
  • "every_2_weeks"
  • "every_4_weeks"
  • "twice_monthly_1st_15th"
  • "twice_monthly_15th_last"
  • "every_month"
  • "every_2_months"
  • "every_3_months"
  • "every_4_months"
  • "every_6_months"
  • "every_year"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/households/string/recurring-transactions/suggestions/restore" \  -H "Content-Type: application/json" \  -d '{    "merchant_id": "Mr9dL3xT6bQa",    "amount": {      "amount": "68.42",      "currency": "USD"    },    "frequency": "every_week"  }'
Empty