FDIC APIbanks.data.fdic.gov ↗
Access FDIC bank data: institution details, financials, branch locations, failures, acquisitions, deposit summaries, and history events via 11 structured endpoints.
What is the FDIC API?
This API exposes 11 endpoints covering the full FDIC BankFind dataset, giving developers structured access to U.S. bank institution records, quarterly financials, branch locations, and failure history dating back to 1934. The get_bank_failures endpoint returns failure records with fields like FAILDATE, COST, and RESTYPE, while search_institutions lets you filter across the full insured-institution registry by state, name, or certificate number.
curl -X GET 'https://api.parse.bot/scraper/f26dbfee-aeb0-415b-8a4e-2b9b66af2d24/get_bank_acquisitions?cert=3510&start_date=2010-01-01' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace banks-data-fdic-gov-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: FDIC BankFind Suite — search institutions, drill into details and sub-resources."""
from parse_apis.fdic_bankfind_suite_api import FDIC, Changecode, InstitutionNotFound
client = FDIC()
# Search for California banks — filter-based search is most reliable.
for bank in client.institutions.search(filters="STNAME:California", limit=5):
print(bank.name, bank.city, bank.state_code, bank.assets)
# Drill into a specific institution by CERT number.
try:
bofa = client.institutions.get(cert="3510")
print(bofa.name, bofa.city, bofa.web_address)
except InstitutionNotFound as exc:
print(f"Institution not found: {exc}")
# Walk sub-resources: branches, financials, acquisitions.
institution = client.institution(cert="3510")
for branch in institution.locations.list(limit=3):
print(branch.office_name, branch.city, branch.state_code)
for quarter in institution.financials.list(limit=2):
print(quarter.report_date, quarter.assets, quarter.return_on_equity)
for acq in institution.acquisitions.list(start_date="2010-01-01", limit=3):
print(acq.bank_name, acq.city_name, acq.date_of_acquisition)
# Query history events by change code — uses the Changecode enum.
for event in client.historyevents.search(changecode=Changecode._223, limit=3):
print(event.institution_name, event.effective_date, event.change_description)
# Bank failures in California.
for failure in client.bankfailures.list(filters="PSTALP:CA", limit=3):
print(failure.name, failure.city, failure.failure_date, failure.cost)
print("exercised: institutions.search / institutions.get / locations.list / financials.list / acquisitions.list / historyevents.search / bankfailures.list")
Retrieve the list of all banks acquired by a specified bank. Filters by the acquiring bank's certificate number (CERT) and optionally by date range. Returns a processed array of acquisitions including bank name, date, city, and state. Returns an empty array with total 0 when no acquisitions match.
| Param | Type | Description |
|---|---|---|
| certrequired | string | FDIC certificate number of the acquiring bank (e.g., '3510' for Bank of America). |
| start_date | string | Filter for acquisitions occurring on or after this date (YYYY-MM-DD format). |
{
"type": "object",
"fields": {
"total": "integer total count of matching acquisitions",
"acquisitions": "array of acquisition records with bank_name, date_of_acquisition, bank_id, city_name, state_name, surviving_bank_name, changecode_desc"
},
"sample": {
"data": {
"total": 3,
"acquisitions": [
{
"bank_id": 33318,
"bank_name": "FIA Card Services, National Association",
"city_name": "Wilmington",
"state_name": "DE",
"changecode_desc": "Merger -Without Assistance",
"date_of_acquisition": "2014-10-01T00:00:00",
"surviving_bank_name": "Bank of America, National Association"
}
]
},
"status": "success"
}
}About the FDIC API
Institution Search and Details
The search_institutions endpoint accepts either a full-text query string or a filters parameter using FDIC field syntax (e.g., STNAME:California, STALP:CA, CERT:3510). It returns paginated arrays of institution records including NAME, CERT, CITY, ASSET, DEP, and WEBADDR. For a single known institution, get_institution_details takes a CERT number and returns one complete record with address, regulatory classification, financial indicators, and web address. Note that full-text search via the query param can return sparse results for some inputs; field-level filters are more reliable.
Financial and Historical Data
get_institution_financials returns quarterly financial snapshots per institution — fields include ASSET, DEP, NETINC, ROA, ROE, REPDTE, and NUMEMP — sorted by report date descending. get_historical_summary aggregates data at the state level by year, splitting results between commercial banks (CB) and savings institutions (SI), with fields like BANKS, OFFICES, and NETINC. get_institution_history and get_history_by_changecode expose structure change events: mergers, branch closings, name changes, and other regulatory events identified by CHANGECODE and described in CHANGECODE_DESC.
Locations, Deposits, and Failures
get_institution_locations returns all branch and office records for a given CERT, including ADDRESS, LATITUDE, LONGITUDE, OFFNAME, and SERVTYPE_DESC. Results are paginated at up to 100 per request. get_summary_of_deposits provides annual branch-level deposit data (DEPSUM, DEPSUMBR, NAMEBR, CITYBR) filterable by CERT, YEAR, or state abbreviation. get_bank_failures covers every FDIC-recorded bank failure from 1934 onward, with filters for state (PSTALP) or year (FAILYR), returning FAILDATE, SAVR, COST, and RESTYPE per record.
Acquisitions and Demographics
get_bank_acquisitions takes an acquiring bank's CERT and an optional date range, returning a list of acquired institutions with bank_name, date_of_acquisition, city_name, and state_name. get_demographics returns quarterly office counts, CBSA classifications, and geographic indicators (METRO, OFFTOT, OFFDMULT) linked to institution locations, filterable by CERT or metro area name.
The FDIC API is a managed, monitored endpoint for banks.data.fdic.gov — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when banks.data.fdic.gov changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official banks.data.fdic.gov API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Map every branch location for a bank using LATITUDE and LONGITUDE fields from
get_institution_locations - Track quarterly asset and net income trends for a specific institution using
get_institution_financials - Build a U.S. bank failure timeline from 1934 to present using FAILDATE and COST fields from
get_bank_failures - Identify all institutions acquired by a holding company using
get_bank_acquisitionswith the acquirer's CERT - Compare state-level aggregate bank assets and deposits across years using
get_historical_summary - Audit merger and name-change history for a regulated institution via
get_history_by_changecodewith code 223 or 520 - Analyze branch-level deposit concentration by filtering
get_summary_of_depositsby CERT and YEAR
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does the FDIC provide an official developer API for this data?+
How does filtering work in endpoints like `get_bank_failures` and `search_institutions`?+
filters parameter using FDIC field syntax: field name, colon, value (e.g., PSTALP:CA or FAILYR:2023). Multiple conditions are joined with AND (e.g., YEAR:2020 AND STNAME:California). Field names are case-sensitive FDIC column names. For institution search, CERT, NAME, STALP, and STNAME are the most commonly used filter fields.How far back does the bank failure data go, and are all resolution types included?+
get_bank_failures endpoint covers failures recorded by the FDIC from 1934 to the present. Each record includes a RESTYPE field describing the resolution method (e.g., deposit payoff, purchase and assumption) and a COST field for estimated loss to the deposit insurance fund.Does the API return real-time or intraday financial data for institutions?+
get_institution_financials is quarterly — each record corresponds to one reporting period identified by REPDTE. Intraday prices, live balance sheet figures, and stock data are not part of the FDIC BankFind dataset. You can fork this API on Parse and revise it to add endpoints pulling from other financial data sources if real-time figures are needed.