fdic_search_institutions
Search FDIC-insured institutions for bank due diligence using filters like name, state, city, or certificate number. Paginate and sort results.
Instructions
Search the FDIC-insured-institution directory (keyless FDIC BankFind, api.fdic.gov/banks/institutions) — a regulated-entity directory for B2G counterparty / bank due-diligence. Structured filters: state (2-letter, → STALP), activeOnly (→ ACTIVE 1/0), cert (→ CERT, the STABLE entity key), plus name/city matched via FDIC's case-insensitive full-text search param (NOT filters — filters=NAME:"chase" is case-sensitive exact-keyword and returns a false-empty; search=NAME:chase finds JPMorgan Chase etc.). limit (≤1000, def 100), offset (≤100000), sortBy (allowlisted enum NAME/CERT/ASSET/ESTYMD/STALP/CITY/ACTIVE), sortOrder (ASC/DESC). Returns { institutions:[{ name, city, state, cert, assetUSD, active, establishedDate, id }] }. HONESTY: totalAvailable is the EXACT meta.total (stable across offset — never the page length); ASSET is published in $thousands and normalized to whole USD ×1000 (null-never-0 — a real 0 stays 0, absent → null); the ONLY honest empty is meta.total:0/data:[] ⇒ complete:true/total:0, every other envelope (400 errors[]/404/non-JSON/missing meta or data) THROWS (never a fake empty); a multi-word name/city is matched per-token (disclosed); the point-in-time snapshot build time is disclosed. NOTE: FDIC keys on CERT, not SAM UEI/DUNS.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cert | No | Filter by FDIC certificate number (the STABLE entity key; → CERT filter). | |
| city | No | Filter by CITY via FDIC full-text `search` (case-insensitive token match). | |
| name | No | Filter by institution NAME via FDIC full-text `search` (case-insensitive token match; NOT case-sensitive exact-keyword — that is why we route to `search`, not `filters`). | |
| limit | No | Rows per page, 1..1000, default 100. | |
| state | No | Filter by 2-letter US state code (uppercase; → STALP filter). e.g. 'VA'. | |
| offset | No | 0-based row offset for pagination, 0..100000, default 0. | |
| sortBy | No | Optional sort field (an allowlisted enum; an unknown field is rejected before fetch). | |
| sortOrder | No | Sort direction when sortBy is set, ASC (default) or DESC. | |
| activeOnly | No | Filter to active (true → ACTIVE:1) or inactive (false → ACTIVE:0) institutions; omit for both. |