Search documentation
Fuzzy search across every docs page and section
API referenceRecurring
Fuzzy search across every docs page and section
API referenceRecurring
API reference
POST /v1/recurring/get — detected recurring streams: subscriptions, bills, and income, with cadence and next expected date.
All endpoints are POST with a JSON body, authenticated with your secret key (Authentication). Errors use the standard envelope; money is in major units with an iso_currency_code; dates are YYYY-MM-DD strings.
/v1/recurring/getReturns recurring transaction streams detected across the item's history — subscriptions, bills, rent, payroll — each with cadence, averages, and the next expected date. Requires the recurring product scope. A recurring.updated webhook fires when streams change.
access_tokenstringrequiredcurl https://api.feelconnect.dev/v1/recurring/get \-H "Authorization: Bearer $FEELCONNECT_SECRET_KEY" \-H "Content-Type: application/json" \-d '{"access_token":"fc_at_…"}'
{"recurring_streams": [{"recurring_id": "rcr_1pL4kN7jH2gF5dS8aQ3w","merchant_name": "Streamflix","description": "STREAMFLIX MONTHLY","category": "Entertainment","cadence": "monthly","average_amount": 15.99,"last_amount": 15.99,"last_date": "2026-07-12","next_date": "2026-08-12","is_subscription": true,"direction": "outflow","status": "active"},{"recurring_id": "rcr_9wX2cV5bN8mK1jH4gF7d","merchant_name": "Northwind Software","description": "NORTHWIND SOFTWARE PAYROLL","category": "Income","cadence": "biweekly","average_amount": 3184.62,"last_amount": 3184.62,"last_date": "2026-07-17","next_date": "2026-07-31","is_subscription": false,"direction": "inflow","status": "active"}]}
recurring_idstringrcr_….merchant_namestringdescriptionstring | nullcategorystring | nullcadenceenumweekly | biweekly | monthly | quarterly | annualaverage_amountnumberlast_amountnumber | nulllast_datestringYYYY-MM-DD of the latest occurrence.next_datestring | nullis_subscriptionbooleandirectionenumoutflow | inflowstatusenumactive | paused | ended