Penny Docs
Recurring transactions

Dismiss Suggestion

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

Suppresses one suggested recurring series identified by merchant, amount, currency, and frequency. Existing transactions and saved recurring series are retained.

Each request dismisses one series. Repeating the same request can suppress additional identical series, so this operation is not idempotent. Use the restore-suggestion endpoint to reverse one dismissal. 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

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/dismiss" \  -H "Content-Type: application/json" \  -d '{    "merchant_id": "Mr9dL3xT6bQa",    "amount": {      "amount": "68.42",      "currency": "USD"    },    "frequency": "every_week"  }'
Empty