FDIC BankFind Suite · Institutions
banks-data-fdic-gov/bank-data/institutionsGet market and financial data with FDIC BankFind Suite · Institutions from Alexandria through one Spiral API key. Find a US bank or savings institution and its FDIC certificate number (CERT), which every other function filters on, or list banks by state, size or status. It runs in the background and returns structured JSON. Pay as you go, with no subscription.
Pricing
$0.00873 per call.
Limits
- Runs
- In the background
- Returns
- json
- Longest queue wait
- 1 hour
- Run deadline
- 5 minutes
- Longest run, end to end
- 225 minutes
- Largest inline input
- 1 MB
- Largest input file
- 2 GB
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
cert | number 1 to 9999999 | — | FDIC certificate number, the institution id shared by every BankFind dataset (3511 = Wells Fargo Bank, N.A.; 628 = JPMorgan Chase Bank, N.A.). Find it with |
city | text | — | Exact city, matched against |
name | text | — | Fuzzy name search over current and prior names (BankFind |
state | text | — | Two-letter state or territory code, matched against |
active | true or false | — | true for institutions open and insured today, false for closed ones. Omit for both. |
cursor | text | — | next_cursor from the previous page of the same query (the record offset). |
fields | list | — | Projection: column names to return instead of the default set, e.g. ["ASSET", "DEP", "ROA", "WEBADDR"]. The identity columns are always added and every record carries |
filters | text | — | Raw BankFind filter, ANDed with the other inputs. Lucene-style: |
sort_by | list | — | Columns to sort by, in priority order, e.g. ["DEP"] or ["NAME"]. Defaults to |
page_size | number 1 to 1000 | 25 | Records per page. |
sort_order | one of asc, desc | — | Direction for every sort column. Defaults to the direction of the default sort. |
Same request in code
curl https://api.spiral.ai/v1/runs \
-H "Authorization: Bearer $SPIRAL_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"provider": "alexandria",
"model": "banks-data-fdic-gov/bank-data/institutions",
"input": {
"cert": 1
}
}'Frequently asked questions
How much does FDIC BankFind Suite · Institutions cost?
$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use FDIC BankFind Suite · Institutions through an API?
Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "banks-data-fdic-gov/bank-data/institutions"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.
Do I need an account with Alexandria to use FDIC BankFind Suite · Institutions?
No. Spiral runs it on its own Alexandria account and charges your Spiral balance.
Can my AI agent use FDIC BankFind Suite · Institutions?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.