BankFind Suite: API for Data Miners & Developers
Overview
FDIC’s application programming interface (API) lets developers access FDIC’s publically available bank data. This portal provides a complete API solution for building applications using this data. Everything you need to integrate with this API is available below. More data will be added to the portal on an ongoing basis.
Authentication
This API is open to the public and does not currently require any authentication or API keys to access. The FDIC is collaborating with on the issuance and management of an API key. More information will be provided on how to obtain an API key in the near future.
Feedback
Provide feedback or submit a question about this page.
BankFind Suite Feedback Survey
Your feedback is important. Help us make this site better by taking a quick survey.
Bulk Files
The following documentation describes performing queries on datasets. If you would prefer a bulk download of all records, downloadable bulk files are available here:
- Institutions (CSV format) - Listing of FDIC-insured banking institution demographic and headquarter location data.
- Institutions Definitions (CSV format) - Definitions of fields in Institutions data.
- Institution API Definitions (YAML format) - for financial institutions.
- Locations (CSV format) - Listing of FDIC-insured banks branches and locations.
- Locations Definitions (CSV format) - Definitions of fields in Locations data.
- Location API Definitions (YAML format) - for financial institutions locations/branches.
- History Events Definitions (CSV format) - Definitions of fields in History data.
- History API Definitions (YAML format) - for details on structure change events.
- Summary API Definitions (YAML format) - for aggregate financial and structure data, subtotaled by year, regarding financial institutions.
- Failure API Definitions (YAML format) - for details on failed financial institutions.
- Summary of Deposits API Definitions (YAML format) - for details on sod institutions.
- Financial API Definitions (YAML format) - for financial information for financial institutions.
- Links to Create Common Financial Reports (.xlsx spreadsheet)
API Documentation
See interactive documentation available below to provide an overview of the API.
Filter Syntax
The API uses the Elastic Search query string syntax for filtering. Some notes on the filter syntax include:
-
To match a phrase, use double quotes:
NAME:"First Bank"
-
To exclude a phrase or value:
!(STNAME:"Virginia")
-
The "AND" and "OR" operators can be used to combine filters:
NAME:"First Bank" AND STALP:IA
NAME:"First Bank" OR NAME:"Unibank"
!(BKCLASS:NM OR BKCLASS:N)
-
Dates must be entered in "yyyy-mm-dd" format:
DATEUPDT:2010-01-25
-
Ranges can be expressed with "[]" (inclusive) or "{}" (exclusive),
using "*" for an open ended range
-
Date range that includes 2010-01-01 and 2010-12-31:
DATEUPDT:[2010-01-01 TO 2010-12-31]
-
Date range that includes only dates between 2010-01-01 and
2010-12-31:
DATEUPDT:{2010-01-01 TO 2010-12-31}
-
Number range including institutions with domestic deposits under
10,000 ($thousands)
DEPDOM:[* TO 10000]
-
Date range that includes 2010-01-01 and 2010-12-31:
-
Open ended ranges can be expressed using a "*"
DATEUPDT:[2010-01-01 TO *]
Output Formats
Data output is available as JSON or CSV. The format is controlled by
the
Accept
header. See the Responses section in the
interactive documentation below for examples.