Search documentation
Fuzzy search across every docs page and section
API referenceAccounts
Fuzzy search across every docs page and section
API referenceAccounts
API reference
POST /v1/accounts/get and /v1/accounts/balance/get — normalized accounts with current, available, and limit balances.
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/accounts/getReturns every account the user shared for this item, with balances as of the last sync, plus the item.
access_tokenstringrequiredcurl https://api.feelconnect.dev/v1/accounts/get \-H "Authorization: Bearer $FEELCONNECT_SECRET_KEY" \-H "Content-Type: application/json" \-d '{"access_token":"fc_at_…"}'
{"accounts": [{"account_id": "acct_9hK2mQxP7cW1nR4tYb8s","name": "Everyday Checking","official_name": "Meridian Trust Everyday Checking","type": "depository","subtype": "checking","mask": "4821","balances": {"current": 4327.18,"available": 4212.03,"limit": null,"iso_currency_code": "USD"},"verification_status": "verified"},{"account_id": "acct_5tGb2VnM8kQ4wZ1xLp0d","name": "Cashback Card","official_name": "Meridian Trust Cashback Rewards Card","type": "credit","subtype": "credit_card","mask": "0093","balances": {"current": 1184.52,"available": 8815.48,"limit": 10000,"iso_currency_code": "USD"},"verification_status": "verified"}],"item": {"item_id": "item_7dJ3nWqZ5xC9vK1mTf4g","institution_id": "inst_meridian_trust","institution_name": "Meridian Trust","connector": "sandbox","status": "active","error": null,"consented_products": ["transactions","balances","recurring"],"last_successful_sync": "2026-07-27T06:00:41.000Z"}}
/v1/accounts/balance/getFetches balances from the connector on demand instead of serving the cached values. Slower than /accounts/get; use it only when freshness matters more than latency (for example, pre-payment checks).
curl https://api.feelconnect.dev/v1/accounts/balance/get \-H "Authorization: Bearer $FEELCONNECT_SECRET_KEY" \-H "Content-Type: application/json" \-d '{"access_token":"fc_at_…"}'
{"accounts": [{"account_id": "acct_9hK2mQxP7cW1nR4tYb8s","name": "Everyday Checking","official_name": "Meridian Trust Everyday Checking","type": "depository","subtype": "checking","mask": "4821","balances": {"current": 4327.18,"available": 4212.03,"limit": null,"iso_currency_code": "USD"},"verification_status": "verified"}]}
account_idstringacct_…. Never changes for the life of the item.namestringofficial_namestring | nulltypeenumdepository | credit | loan | investment | crypto | paymentsubtypestring | nullchecking, savings, credit_card, 401k.maskstring | nullbalances.currentnumbercredit accounts this is the amount owed.balances.availablenumber | nullbalances.limitnumber | nullbalances.iso_currency_codestringUSD.verification_statusstringverified.