Get detail on historical bank failures from 1934 to present.
GET {{baseUrl}}/failures?filters=FAILYR:["2014" TO "2015"]&fields=NAME,CERT,FIN,CITYST,FAILDATE,SAVR,RESTYPE,RESTYPE1,QBFDEP,QBFASSET,COST&sort_by=FAILDATE&sort_order=DESC&limit=10&offset=0&total_fields=QBFDEP,QBFASSET,COST&subtotal_by=RESTYPE&agg_by=FAILYR&agg_term_fields=RESTYPE&agg_sum_fields=QBFASSET,QBFDEP,COST&agg_limit=10&format=json&download=true&filename=data_file
Returns details on failed financial institutions.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
filters | string | The filter criteria that refines the records returned. | |
Examples: |
- Filter by Location
CITYST:"MEMPHIS, TN"
- Filter all but a specified value
!(CITY:"PITTSBURGH")
- Filter by institution fail year range
FAILYR:["2015" TO "2016"]
| |fields
| string | | Comma delimited list of fields of failed financial institutions to return. | |sort_by
| string | | Field name by which to sort returned data | |sort_order
| string | | Indicator if ascending (ASC) or descending (DESC) | |limit
| number | | The number of records to return. Default is 10 and maximum is 10,000. | |offset
| number | | The offset of page to return. | |total_fields
| string | | Fields to sum up (in a totals response object). Only numeric columns are valid. | |subtotal_by
| string | | The field by which data will be subtotaled (in totals response object). Only categorical values should be used. | |agg_by
| string | | The field(s) by which data will be aggregated. Valid values are 'FAILYR' or 'FAILYR,PSTALP'. | |agg_term_fields
| string | | The field(s) for which aggregations will be counted for each unique term. | |agg_sum_fields
| string | | The field(s) for which aggregations will be summed or aggregated. | |agg_limit
| number | | The limit on how many aggregated results will be displayed | |format
| string | | The format of the data to return. | |download
| boolean | | Whether the data should be downloaded as a file. | |filename
| string | | The filename to use when downloading data. |
RESPONSES
status: OK
{"meta":{"total":54019330,"parameters":{},"index":{"name":"ipsum eiusmod tempo","createTimestamp":"1997-05-29T15:19:02.652Z"}},"data":[{"value":"reference failure_properties.yaml not found in the OpenAPI spec"},{"value":"reference failure_properties.yaml not found in the OpenAPI spec"}],"totals":{"count":33503805}}