Skip to main content

Historical Credit Score Files

To support the industry in transitioning to the new Credit Score models, Fannie Mae is providing anonymous historical credit scores based on VantageScore® 4.0.

Three data files are available representing:

  • Loans acquired by Fannie Mae from approximately April 2013 to March 2023 (which closely aligns with applications/originations from approximately January 2013 to December 2022).
    • Note: A key component of the VantageScore 4.0 credit score model is its use of trended data which is only available across all three credit bureaus starting from January 2013.
  • Values based on information provided by the three bureaus (tri-merge) and various combinations of two bureaus (bi-merge).

Access the Data

To access the historical credit score files, click on the Register/Login to download link provided below. New users must first register and accept the Terms and Conditions and privacy notice before downloading the files. Data Dynamics® users may use their existing credentials to log in to access the files.

Historical Credit Score Files

Register/login to download VantageScore 4.0 historical credit score files for Mortgage-Backed Securities (MBS) Disclosures, Historical Loan Performance, and Credit Risk Transfer (CRT) Datasets.

Register/Login to download

Note: Due to the file size (10M+ records), files are meant to be consumed by advanced analytics programs.

Disclaimers: When using the historical credit score files, it is important for users to understand the following information on the data contained in the files.

  1. The credit scores contained in the historical credit score files are generated by Equifax, Experian, and TransUnion based on the archive credit data from that credit bureau. We do not make any representations or warranties concerning the quality, accuracy, or completeness of the historical data generated by these third parties or the adequacy or suitability of the historical credit score files for any use or purpose.
     
  2. The type, content, format, structure, and quality of this data depends on how this data was collected and stored at the specific time the archive was created. This may be a different time than the time at which the credit report used at origination was generated for the loans included in the files. This difference in timing may lead to differences in credit scores between the archive credit data and the origination credit data.
     
  3. Archive credit data may not reflect more recent updates in the content and structure of credit reports. For instance, changes over time to the reporting of medical collections, tax liens, judgments, student loan forbearance, and rental payments (among other things) will not be reflected in scores generated based on credit data archived before these those changes went into effect.
     
  4. The historical credit score files must not be used to, directly or indirectly, identify any specific individual. Users must comply with the Terms and Conditions, which contain important information on the permitted uses and restrictions for the data contained in the historical credit score files.

How to Use the Historical Credit Score Files with the Disclosure Datasets (MBS, Historical Loan Performance and CRT)

When using the historical credit score files, it's important for users to understand that the “common” Loan Identifier matches the Loan Identifiers published in our disclosure datasets. The Loan Identifier does not correspond to the Fannie Mae Loan Number or Lender Loan Number. The historical credit score files are primarily intended to be combined with the MBS disclosures, or Historical Loan Performance or CRT datasets to perform the analytics needed to implement VantageScore 4.0.

What Loan Identifiers Will Match

Historical Credit Score Loan Identifier GSE Loan Number Lender Loan Number MBS Disclosures Loan Identifier Historical Loan Performance Dataset Loan Identifier CRT Dataset Loan Identifier
5968784709 red x red x green checkmark red x red x
100023020488 red x red x red x green checkmark red x
136626329 red x red x red x red x green checkmark

Historical Credit Score Loan Identifier

5968784709

GSE Loan Number

red x

Lender Loan Number

red x

MBS Disclosures Loan Identifier

green checkmark

Historical Loan Performance Dataset Loan Identifier

red x

CRT Dataset Loan Identifier

red x

Historical Credit Score Loan Identifier

100023020488

GSE Loan Number

red x

Lender Loan Number

red x

MBS Disclosures Loan Identifier

red x

Historical Loan Performance Dataset Loan Identifier

green checkmark

CRT Dataset Loan Identifier

red x

Historical Credit Score Loan Identifier

136626329

GSE Loan Number

red x

Lender Loan Number

red x

MBS Disclosures Loan Identifier

red x

Historical Loan Performance Dataset Loan Identifier

red x

CRT Dataset Loan Identifier

green checkmark

Note: One additional attribute (besides the Loan Identifier) will be required to match the loan information across both data sets.

View examples of using historical credit score files with disclosure datasets

Sample Files and Glossary and File Layouts

The sample and glossary layout files below do not require registration or login.

MBS Disclosures Dataset

 

VantageScore 4.0

Sample File

Glossary and File Layout

Access the MBS Disclosures Dataset (available in PoolTalk®).

Historical Loan Performance Dataset

 

VantageScore 4.0

Sample File

Glossary and File Layout

Access the Single-Family’s Historical Loan Performance Dataset (available in Data Dynamics®).

CRT Dataset

VantageScore 4.0

Sample File

Glossary and File Layout

Access the CRT Dataset (available in Data Dynamics).

Historical Credit Score Frequently Asked Questions (FAQs)

Q1. What credit score data are the GSEs publishing in the historical credit score files?

To assist market participants in the transition from Classic FICO to the new credit score models, the GSEs have published data files with historical credit score information for VantageScore 4.0 based on the Average then Average loan-level score calculation methodology. The current calculation methodology is also provided (see question 13) for details on the current calculation methodology. The historical files include loans acquired by the GSEs from approximately April 2013 to March 2023 (i.e., applications/originations from approximately January 2013 to December 2022).

Q2. Why isn’t historical credit score data available prior to 2013?

Trended data is a key component of the new scoring models and, following discussions with the credit bureaus, it was confirmed that they do not have consistent trended data to support the calculation of FICO® 10 T and VantageScore 4.0 prior to 2013.

Q3. What credit score fields are being provided in the historical files?

The historical credit score data below has been published in each file along with Loan Identifiers and reference data elements (refer to the glossary and file layouts).

  • VantageScore 4.0 (Tri-Merge) Current Method (calculated using the middle/lower then lowest methodology)
  • VantageScore 4.0 Tri-Merge (Average/Average)
  • VantageScore 4.0 Bi-Merge (Average/Average) Lowest Bi-Merge Combination
  • VantageScore 4.0 Bi-Merge (Average/Average) Median Bi-Merge Combination
  • VantageScore 4.0 Bi-Merge (Average/Average) Highest Bi-Merge Combination

Q4. Are the historical credit score files aligned between the GSEs?

The GSEs’ historical credit score files are aligned, but the attribute names or descriptions may differ slightly. Please refer to the GSEs’ respective resources (glossary and file layouts) for details.

Q5: Why are there loans in the MBS loan-level disclosure dataset that are not included in the VantageScore 4.0 historical scores for MBS Disclosures file?

The VantageScore 4.0 historical scores for the MBS Disclosures Dataset only encompass loans acquired by the GSEs from approximately April 2013 through March 2023, which is a subset of acquired loans in our MBS disclosures. Additional exclusions from the VantageScore 4.0 historical scores for MBS disclosures include loans in collapsed or dissolved MBS, and Reperforming or Modified MBS.

Q6: Do the VantageScore 4.0 historical scores reflect the same time period as the Classic FICO scores representing the time of origination that is provided in the MBS, Credit Risk Transfer (CRT), and Historical Loan Performance disclosure datasets?

The historical files include loans acquired by the GSEs from approximately April 2013 to March 2023 (i.e., applications/originations from approximately January 2013 to December 2022), estimating the timing when the lender likely accessed the Classic FICO scores for origination. However, the credit scores contained in the historical credit score files are based on archive credit data that was generated at a specific time in the month the archive was created. This may be a different time than the date for which the credit report used at origination was actually generated for the loans. This difference in timing may lead to differences in credit scores between the archive credit data and the origination credit data.

Q7: Where can I access the MBS, CRT, and Historical Loan Performance disclosure datasets?

Fannie Mae

For Fannie Mae, the MBS loan-level disclosures can be found in Pooltalk under the Resources > Data Collection section, which is free to access, though registration is required.

Fannie Mae published a Classic FICO historical file based on the current methodology for all active and inactive loans that are included in the VantageScore 4.0 historical file for MBS. This file can be found in the Miscellaneous folder in the data collection location on PoolTalk. The file format for the Classic FICO historical file can be found in the Pooltalk Learning Center.

Fannie Mae's CRT and Historical Loan Performance data is available in Data Dynamics. Data Dynamics is free to access, though registration is required. There is no additional Classic FICO historical file for CRT and Single-Family Loan Level Dataset given that both datasets contain active and inactive loans.

Freddie Mac

For Freddie Mac, the MBS loan-level disclosures can be found in Security Lookup under the Data Files and Reports section, which is free to access, though registration is required. Freddie Mac also published a Classic FICO historical file for all active and inactive loans that are included in the VantageScore 4.0 historical file for MBS. This file is located in the Miscellaneous folder in the Data Files and Reports section of Security Lookup.

Freddie Mac's CRT loan-level disclosures are available in Clarity and historical loan-level data is available via the Single Family Loan Level Dataset webpage. Both disclosure datasets are free to access, though registration is required. There is no additional Classic FICO historical file for CRT and Single-Family Loan Level Dataset given that both datasets contain active and inactive loans.

Please note that the historical credit score files are accessible from the ‘Credit Score Models and Reports Initiative’ webpage for each GSE. From there, users may access the data at no cost after registering for access (via a webpage hosted by Finsight Group, Inc for Freddie Mac) and accepting the Terms and Conditions.

Q8: Why do the historical files for CRT and the Historical Loan Performance data provide loan representative credit scores when the corresponding datasets provide borrower and co-borrower representative credit score?

Under the current methodology, one of the borrowers’ representative credit scores at origination is equivalent to the loan representative credit score at origination. This allows for consistency between publicly provided datasets that include either the borrower or loan representative credit scores. The new methodology of Average then Average does not facilitate this same paradigm in which one of the borrower’s representative credit scores at origination is equivalent to the loan’s representative credit score at origination.

With the introduction of the new credit scores, Fannie Mae intends to disclose the loan representative credit score at origination for the CRT and Historical Loan Performance datasets to maintain consistency between our publicly provided datasets.

Please note that this change does not apply to Freddie Mac as the MBS, CRT and Historical Loan Performance data already discloses a loan-level Indicator credit score.

Q9: What are the limitations for using the Classic FICO credit scores in the CRT disclosure dataset?

Please review the Terms and Conditions of use for CRT disclosure dataset and note that the terms are different for the Credit Score at Origination versus the Credit Score at Issuance and Credit Score Current fields.

Q10: Why does the most recently published MBS Loan Level Disclosure Dataset not include all the loans published in the MBS historical credit score file?

The most recently published MBS Loan Level Disclosure dataset only contains active loans; inactive loans are removed from the dataset at the time of the liquidation of the loan. To assist with stakeholders’ analysis, Fannie Mae and Freddie Mac published a Classic FICO historical file that provides the disclosed credit score value for all active and inactive MBS loans that are included in the VantageScore 4.0 Historical Scores for MBS Disclosures file. For Fannie Mae, this file can be found in Pooltalk under the Resources > Data Collection section. For Freddie Mac, this file can be found in Security Lookup under the Miscellaneous folder in the Data Files and Reports section.

Q11: Can I use Excel to view the historical credit score files?

The historical credit score files contain millions of loans and are meant to be used in a data analysis tool; the files are too large to be opened in a spreadsheet tool such as Excel. The loan count and file sizes are:

For Fannie Mae:

File Name Loan Count File Size (Zipped)
VantageScore 4.0 Historical Scores for MBS Disclosures 27,384,198 ~250MB
VantageScore 4.0 Historical Scores for CRT Dataset 10,874,871 ~94MB
VantageScore 4.0 Historical Scores for Historical Loan Performance Dataset 25,081,784 ~250MB

For Freddie Mac:

File Name Loan Count File Size (Zipped)
VantageScore 4.0 Historical Scores for MBS Disclosures 20,510,982 ~185MB
VantageScore 4.0 Historical Scores for CRT 13,155,604 ~109MB
VantageScore 4.0 Historical Scores for Historical Loan Performance 20,196,180 ~167MB

Q12: When will FICO Score 10 T historical credit scores be published?

The GSEs, in collaboration with FHFA, are working to make FICO Score 10 T historical credit scores available to market participants as soon as possible.

Q13: What loan-level credit score calculation methodology was used to produce the VantageScore 4.0 historical credit scores?

The VantageScore 4.0 historical credit scores were calculated using two methods: Our current Middle/Lower then Lowest methodology and the proposed new Average then Average methodology.

Current Methodology: Uses the tri-merge Middle/Lower then Lowest methodology, where the middle of the three or lower of the two credit bureau scores is selected for each borrower, and then the lowest score of all borrowers on the loan is chosen. The Classic FICO calculation methodology will not be changing, and the data is already available through the existing disclosure datasets.

Proposed New Methodology: In the Average then Average methodology, the available credit scores from each credit bureau for each borrower are averaged. If there is more than one borrower, then a simple average of all the borrowers’ average credit scores is calculated. If no VantageScore 4.0 credit score was available from any bureau, the loan was excluded from the historical file.

Q14: How are the values for the bi-merge lowest, median, and highest fields calculated?

The bi-merge credit scores reflect data from the credit bureaus: Equifax, Experian and TransUnion. For each borrower on the loan, the average of each pairing of the credit bureaus is collected, i.e., the average of the Equifax and Experian scores, the average of the Equifax and TransUnion scores, and the average of the Experian and TransUnion scores. The loan-level credit score is then determined by averaging each borrowers' average of each pairing of the credit bureaus, i.e., the average of all the borrower’s average of the Equifax and Experian, etc. These scores are then ranked from lowest to highest, with the specific bureau combinations varying depending on the borrower and the loan. See example below.

 

A screenshot of a credit score calculator Description automatically generated

 

A note on rounding: In cases where the aggregated (averaged) values fall between two whole numbers, score values are always rounded to the nearest whole number, meaning that a score with a decimal at or above .5 is rounded up, and below .5 is rounded down. Rounding is conducted at each step in the aggregation process (i.e., scores are rounded when aggregated to the borrower level, as well as when borrower-level scores are aggregated to the loan level).

Q15: Do the credit scores represent an ‘at origination’ or more recent score?

The credit score represents an ‘at origination’ value.

Q16: What is the allowable range for a VantageScore 4.0 credit score?

The allowable range is greater than (or equal to) 300 or less than (or equal to) 850.

Q17: What happens if no VantageScore 4.0 credit score was available from a bureau?

If all three bureaus did not provide a score, the loan was excluded from the historical file. Otherwise, the remaining scores obtained were used to determine the credit scores values.

Need help?

For more information, reach out to your Fannie Mae representative or Contact Us for Technology Support.