Skip to main content

HMDA File Serving

The HMDA Platform serves a number of files including:

  1. Documentation
  2. Modified LAR
  3. Institution Register Summaries
  4. Dynamic National Loan-Level Dataset
  5. Snapshot National Loan-Level Dataset
  6. Disclosure Reports
  7. Aggregate Reports
  8. Rate Spread Data

The HMDA Platform serves these files in three seperate ways, through the HMDA File api, Githhub, and S3.

The HMDA File api is used to serve the Modfied LAR and Institution Register Summaries. Github is used to serve documentation in the form of markdown files which are formatted by the HMDA-Frontend. S3 is used to serve all other files

HMDA File API

The HMDA File API is used for accessing the Modified LAR and Institution Register Summaries.

Get Modified LAR Pipe Delimited .txt File

MethodGET
Endpointhttps://ffiec.cfpb.gov/file/modifiedLar/year/{{year}}/institution/{{lei}}/txt

Get Modified LAR Pipe Delimited .txt File with Header

MethodGET
Endpointhttps://ffiec.cfpb.gov/file/modifiedLar/year/{{year}}/institution/{{lei}}/txt/header

Get Modified LAR .csv File

MethodGET
Endpointhttps://ffiec.cfpb.gov/file/modifiedLar/year/{{year}}/institution/{{lei}}/csv

Get Modified LAR .csv File with Header

MethodGET
Endpoint
https://ffiec.cfpb.gov/file/modifiedLar/year/{{year}}/institution/{{lei}}/csv/header

Get Institution Register Summary (IRS)

The IRS is a summary of a institution's HMDA submission to be used by the filing institution to confirm that they are submitting the correct data.

As such, access to each IRS is restricted to users associated with the institution. Users must be authenticated using the HMDA authentication system and include a bearer token with their request.

(More information on authentication can be found above in the Authorization section in the HMDA Platform Filing API section of these docs)

MethodGET
Endpointhttps://ffiec.cfpb.gov/file/reports/irs/year/{{year}}/institution/{{lei}}
HeadersAuthorization: Bearer {{access_token}}

Request:

    curl -X POST "https://ffiec.cfpb.gov/public/rateSpread/reports/irs/year/2019/institution/B90YWS6AFX2LGWOXJ1LD" \
-H 'Authorization: Bearer {{access_token}}'

CSV Response:

    MSA/MD, MSA/MD Name, Total Lars, Total Amount ($000's), CONV, FHA, VA, FSA, Site Built, Manufactured, 1-4 units, 5+ units, Home Purchase, Home Improvement, Refinancing, Cash-out Refinancing, Other Purpose, Purpose N/A
16984,"Chicago-Naperville, IL-IN-WI", 1, 135, 0, 1, 0, 0, 1, 0, 1, 0, 0, 1, 0, 0, 0, 0
27260,"Jacksonville-St. Marys-Palatka, FL-GA", 1, 445, 1, 0, 0, 0, 1, 0, 1, 0, 0, 0, 1, 0, 0, 0

Github File Service

Documentation served from github can be found on the HMDA Frontend github repository

S3 File Service

All other files are accessed through direct links to the HMDA Platform's public S3 bucket. These S3 links are all prefixed with: https://s3.amazonaws.com/cfpb-hmda-public/prod.

ffiec.cfpb.gov

An official website of the CFPB's HMDA  v2.1.2

Looking for U.S. government information and services?  
Visit USA.gov