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 Data.gov 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.

• Full OpenAPI specification (formerly known as Swagger) for 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]

• 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.

API Endpoints