Skip to content

Fannie Mae & Freddie Mac single-family loan-level data

View this page as raw Markdown (.md)

mortgageshousingcreditloan-levelpanel-datafreeacademicdata:fannie-freddie

The Fannie Mae and Freddie Mac single-family loan-level datasets are the two government-sponsored enterprises’ public releases of acquisition and monthly performance records for the single-family mortgages they bought. Each loan has origination characteristics (FICO, LTV, DTI, rate, term, purpose, geography) and a monthly performance history (delinquency status, prepayment, default, losses). They are the standard free microdata for US mortgage credit-risk and performance research. Used in, for example, Rehbein & Rother (2025), where 1.27 million GSE 30-year fixed-rate mortgages (2000 to 2008 originations, observed to 2018) supply loan-level LTV, rate, delinquency, and default.

Both GSEs publish the data through a free registration portal. There is no anonymous direct link to the bulk files.

  • Fannie Mae distributes the Single-Family Loan Performance Data through Data Dynamics. After a free account and terms acceptance, the portal offers a one-click download of the full Acquisition file and the full Performance file, in CSV.
  • Freddie Mac distributes the Single Family Loan-Level Dataset through Clarity Data Intelligence. After a free sign-in (the data is free for non-commercial and academic use), the download page offers the full dataset, the Standard dataset by year, the Non-Standard dataset, sample files, and an RPL mapping file. Files are pipe-delimited.

The public documentation (user guides, file-layout and data-dictionary PDFs, FAQs) is generally readable without an account; the loan-level files and even the sample files are behind the login.

  • Two file types per GSE, joined on the loan id. Acquisition (one static row per loan, captured at origination) and Performance (one row per loan per month). Do not expect a single combined table; the performance file is the large one.
  • Format differs between the two GSEs. Freddie’s files are pipe-delimited (|), no header, with a fixed column order set by the layout document. Fannie’s Data Dynamics export is CSV. Column order, field set, and missing-value conventions differ, so do not reuse one schema for the other.
  • Click-through terms, so no anonymous fetch. An automated pull must carry a session cookie obtained after accepting the terms; there is no static URL to the zips. Plan for a one-time human registration.
  • Quarterly vintages that grow. Acquisition files are partitioned by origination quarter and new quarters are appended over time, so any hardcoded “latest quarter” logic rots. Record the vintage you pulled.
  • Freddie Standard vs Non-Standard. The Non-Standard dataset adds loans excluded from Standard (for example certain modified, ARM, or balloon loans); the RPL mapping file tracks reperforming loans. Choose deliberately rather than mixing them.
  • Scale. Tens of millions of loans and a monthly panel on top; the performance files are tens of gigabytes uncompressed. Stream or chunk; do not load whole.
  • Host bot-blocking on top of the login. The Fannie capitalmarkets host returns HTTP 403 to automated requests even before the login, so scripted navigation needs a real browser session, not just an authenticated cookie.
FieldValue
Fannie portalData Dynamics (capitalmarkets.fanniemae.com/tools-applications/data-dynamics)
Freddie portalClarity Data Intelligence (freddiemac.com/research/datasets/sf-loanlevel-dataset)
File typesAcquisition (per loan) + Performance (per loan per month)
Fannie formatCSV
Freddie formatPipe-delimited, no header
Freddie coverage~55M loans, 1999 to latest quarterly cutoff
Key requiredNo key, but free registration + terms acceptance

Cite each GSE dataset separately: Fannie Mae, “Single-Family Loan Performance Data,” and Freddie Mac, “Single Family Loan-Level Dataset,” each with the vintage (origination-quarter range and performance cutoff) and retrieval date. Note in a methods appendix that access required free registration, since the files are not anonymously downloadable.

Found an error or want a topic covered? Open an issue, use the Edit page link above, or email contact@instituteforautomatedresearch.org. Edits are reviewed before publishing; provenance and accuracy are the point.