Learn R Programming

fcall

R package for parsing Farm Credit Administration (“FCA”) Call Report data into tidy R data frames.

Installation

{fcall} can be installed from CRAN using install.packages("fcall"). Alternatively, you can install the development version from GitHub using {pak} like so:

# install.packages("pak")
pak::pak("ketchbrookanalytics/fcall")

Background

FCA publishes Call Report data on a quarterly basis at https://www.fca.gov/bank-oversight/call-report-data-for-download. Ketchbrook Analytics replicates these files in a public AWS S3 bucket, which {fcall} interacts with via its download_data() function.

As of September 2025, this data represents a set of 72 .TXT files. These files represent 36 datasets. The files prefixed with “D_” contain metadata (the column names, data types, etc.) of the associated file containing the raw, header-less comma-separated data. For example, the file that starts with “D_INST” contains the metadata for the file that starts with “INST_”.

Further, some of these datasets are structured in a way that makes data analysis difficult. In these cases, we chose to pivot the data to make it more analysis-friendly. See Metadata File Scenarios for a more in-depth discussion of when and how this pivoting took place.

This package provides 3 utility functions:

  1. download_data() allows users to programmatically download (and unzip) data from a specific quarter
  2. process_data() parses the data from these unzipped .TXT files into a list of R data frames containing the Call Report data and file metadata
  3. compare_metadata() compares two sets of Call Report data from different quarters

Check out the Getting Started vignette to learn more about these three core functions.

Database

Ketchbrook Analytics has also created a PostgreSQL database to store historical FCA Call Report data in a traditional, relational schema that aligns with the output data frame structure resulting from running process_data(). This database allows users to execute SQL queries to easily analyze Call Report data across multiple quarters.

Please reach out to info@ketchbrookanalytics.com if you would like access to this database.

Copy Link

Version

Install

install.packages('fcall')

Monthly Downloads

171

Version

0.1.6

License

MIT + file LICENSE

Issues

Pull Requests

Stars

Forks

Maintainer

Michael Thomas

Last Published

December 10th, 2025

Functions in fcall (0.1.6)

process_metadata_file

Process metadata file to extract variable information
process_data_file

Process a data file using metadata and codes dictionary
process_data

Process FCA Call Report data in a specified folder
RIE1__ACLCode

Dictionary for ACLCode variable of RIE1 file
compare_files_content

Compare content of a specific file between two folders
RCR7__RegCapCode

Dictionary for RegCapCode variable of RCR7 file
RID__CAP_CODE

Dictionary for RegCapCode variable of RID file
get_codes_dict

Retrieve dictionary of lookup codes for a specified dataset name
RCI2C__ExposureCode

Dictionary for ExposureCode variable of RCI2C file
compare_metadata

Compare FCA Call Report metadata files between two folders
download_data

Download FCA Call Report Data and Unzip
RCI2D__DerivRMCode

Dictionary for DerivRMCode variable of RCI2D file
file_metadata

Descriptions for data files
RCF1__LOANSTATUS

Dictionary for LOANSTATUS variable of RCF1 file
RCB__INV_CODE

Dictionary for INV_CODE variable of RCB file
RCB3__DebtMaturityCode

Dictionary for DebtMaturityCode variable of RCB3 file
RCO__ASSET_CODE

Dictionary for ASSET_CODE variable of RCO file
RCB2__AssetCodeRCB2

Dictionary for AssetCodeRCB2 variable of RCB2 file
read_data_file

Read a data file based on metadata and codes dictionary
RCF__LOANSTATUS

Dictionary for LOANSTATUS variable of RCF file
RCR3__RegCapCode

Dictionary for RegCapCode variable of RCR3 file
RCI2B__DerivCode

Dictionary for DerivCode variable of RCI2B file