Search documentation
Fuzzy search across every docs page and section
API referenceInstitutions
Fuzzy search across every docs page and section
API referenceInstitutions
API reference
POST /v1/institutions/search and /v1/institutions/get_by_id — search the institution network and fetch metadata.
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.
Link searches institutions for you, so most integrations never call these directly — they exist for building custom pickers, status pages, and pre-selecting institution_id in link tokens.
/v1/institutions/searchquerystringrequiredtypesstring[]bank, credit_union, payment_app, investment, crypto_exchange, crypto_wallet, business.country_codesstring[]["US"].curl https://api.feelconnect.dev/v1/institutions/search \-H "Authorization: Bearer $FEELCONNECT_SECRET_KEY" \-H "Content-Type: application/json" \-d '{"query":"meridian","types":["bank"]}'
{"institutions": [{"institution_id": "inst_meridian_trust","name": "Meridian Trust","type": "bank","country_codes": ["US"],"primary_color": "#1E5AA8","monogram": "MT","logo_url": null,"oauth": true,"mfa": false,"status": "healthy"}]}
/v1/institutions/get_by_idinstitution_idstringrequiredinst_… id.curl https://api.feelconnect.dev/v1/institutions/get_by_id \-H "Authorization: Bearer $FEELCONNECT_SECRET_KEY" \-H "Content-Type: application/json" \-d '{"institution_id":"inst_meridian_trust"}'
{"institution": {"institution_id": "inst_meridian_trust","name": "Meridian Trust","type": "bank","country_codes": ["US"],"primary_color": "#1E5AA8","monogram": "MT","logo_url": null,"oauth": true,"mfa": false,"status": "healthy"}}
institution_idstringinst_….namestringtypeenumbank | credit_union | payment_app | investment | crypto_exchange | crypto_wallet | businesscountry_codesstring[]primary_colorstringmonogramstringlogo_urlstring | null/institutions/inst_chase.png. Null for institutions we have no mark for — render the monogram instead.oauthbooleanmfabooleanstatusenumhealthy | degraded | down — current connector health.