getFailures {fdicdata}

Get information on bank failures from FDIC data

Description

This function retrieves information on bank failures from the FDIC data API, using the specified fields and (optional) date range. If a date range is specified, only failures within that range will be included.

Usage

getFailures(fields, range = NULL, limit = 10000)

Arguments

fields

a character vector specifying the fields to include in the output.

NAME

The name of the failed bank

CERT

The FDIC certificate number of the failed bank

FIN

The failed bank's unique financial institution identifier

CITYST

The city and state where the failed bank was located

FAILDATE

The date of the bank failure

FAILYR

The year of the bank failure

SAVR

Whether the failed bank was a savings and loan association

RESTYPE

The type of failed institution

RESTYPE1

A more specific classification of the failed institution

CHCLASS1

The bank's charter class

QBFDEP

The amount of deposits held by the bank at the time of failure

QBFASSET

The total assets held by the bank at the time of failure

COST

The estimated cost to the FDIC of the bank's failure

PSTALP

The FDIC's estimated percentage of insured deposits paid to depositors

range

a numeric vector of length 2 specifying the start and end dates (in YYYY format) for the date range to include. If not specified, all failures will be included.

limit

an integer specifying the maximum number of results to return. Defaults to 10,000.

Value

a data frame containing the requested fields for each bank failure within the specified date range (if applicable).

Examples

df <- getFailures(c("CERT", "NAME", "FAILDATE", "CITY", "STATE"), range = c(2010, 2015))
head(df)