FDIC BankFind Suite · Locations
banks-data-fdic-gov/bank-data/locationsGet market and financial data with FDIC BankFind Suite · Locations from Alexandria through one Spiral API key. Where a bank has branches, or which banks have offices in a city, ZIP or state. Filter by cert (from institutions) for one bank's network. Use deposits for deposits held at each branch and history for branch openings and closings. 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 |
|---|---|---|---|
zip | text | — | Five-digit ZIP code of the office. Pattern: ^[0-9]{5}$. |
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 |
state | text | — | Two-letter state or territory code, matched against |
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. ["ADDRESS", "CITY", "LATITUDE", "LONGITUDE", "SERVTYPE_DESC"]. 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. ["ESTYMD"]. 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/locations",
"input": {
"zip": "<zip>"
}
}'Frequently asked questions
How much does FDIC BankFind Suite · Locations 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 · Locations through an API?
Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "banks-data-fdic-gov/bank-data/locations"` 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 · Locations?
No. Spiral runs it on its own Alexandria account and charges your Spiral balance.
Can my AI agent use FDIC BankFind Suite · Locations?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.