SF.FreddieMac.com

Uniform Loan Delivery Dataset

The Uniform Loan Delivery Dataset (ULDD) supports the work to implement uniform data standards and defines the data that we require at loan delivery based on loan type, loan feature or other business requirements.

Business Resources

ULDD data is granular, standardized, and has clear definitions, providing sellers with a common understanding of the meaning of each data point. The result is greater transparency, which helps sellers gain a better understanding of our assessment of mortgage risk and purchase requirements on loans they sell to us.

ULDD Revisions

The ULDD Revisions webpage is designed to assist you with loan delivery requirement revisions to ULDD since the last publication. The revisions include ULDD specification updates and ULDD impacts that were previously communicated in Single-Family Seller/Servicer Guide (Guide) Bulletins. The webpage will be updated periodically.

September 12, 2023 - ULDD Publication

ULDD Phase 4a Update

Freddie Mac is providing updates to existing ULDD Phase 4a data points (i.e., enumerations, implementation notes, conditionality, and conditionality details).

ULDD Phase 5

The Phase 5 updates add new data points and updates to existing data points to support the Enterprise Credit Score and Credit Reports Initiative, alignment with the new redesigned UAD 3.6 and business critical requirements.

The following resources are available to help you with the implementation of ULDD:

 

Implementation Timeline

What's New

Additional Resources

Technical Resources

The following resources provide the technical documentation that Freddie Mac-approved Sellers and vendors need to implement Freddie Mac's loan delivery data requirements:

Appendix A

Freddie Mac XML Data Requirements, V.6.0.0 announces ULDD Phase 5. Details are located in Tab-9-Revision Log – 09-12-2023. Tab 10-Ph 5 Complete consolidates updates will all previous phases. Updated as of Sep. 12, 2023.

Appendix B

Freddie Mac Test Case Scenarios provides common test case scenarios, including Phase 4a and Phase 5 examples, that illustrate how the loan delivery data is translated into MISMO terms – Updated as of Dec. 19, 2023.

Appendix C

Zipped folder containing examples of well-formed XML for each Appendix B Test Case Scenario – Updated as of Dec. 19, 2023

Appendix D

Freddie Mac XML Data Requirements Reference Tool V.6.0.0, is identical to Appendix A but in Excel format, allowing for easier analysis. Tab 10-Ph 5 Complete consolidates updates with all previous phases. Updated as of Sep. 12, 2023.

Appendix E

Zipped folder containing MISMO 3.0, XLink and ULDD Phase 5 Extension Schema with a visual representation of the extension schema – Updated as of Dec. 19, 2023

Appendix G

Archived Freddie Mac XML Data Requirements Reference Tool V1.0 containing previous ULDD Phases 1, 2 and 3. Updated as of Sep. 12, 2023.

Freddie Mac ULDD Phase 3 Implementation Guide

The Implementation Guide is intended for use by a Freddie Mac-approved seller or vendor to facilitate the development of the interface between their product and Loan Selling Advisor.

ULDD Job Aid for the Alignment with UAD 3.6

The job aid is intended to guide and assist you with the mapping between the ULDD and the redesigned Uniform Appraisal Dataset (UAD). Updated as of Sep. 24, 2024.

Announcements

2023

2022

2021

  • December 14, 2021 – ULDD Phase 4a Specification Release
  • June 8, 2021 – ULDD Updates for CMT-indexed ARMs Retirement, Implementation Notes and Enumerations

2020

  • December 1, 2020 – Updates to Support ULDD LIBOR to SOFR ARM Index Transition, Condo Delivery and Home Possible® Mortgage
  • April 21, 2020 – ULDD Updates Supporting SOFR ARM Index Transition

2019

2018

2017

2016

2013

2012

  • December 13, 2012 – GSEs Publish Phase II ULDD Specification
  • July 20, 2012 – Guide Bulletin 2012-15 Announcement and ULDD Reminders
  • March 23, 2012 – Prepare for April 23 Loan Selling Advisor Update
  • February 17, 2012 – Take Full Advantage of the Loan Selling Advisor CTE Now

Uniform Loan Delivery Dataset (ULDD) - Revisions

Most Recent Updates as of November 6, 2024

The Uniform Loan Delivery Dataset (ULDD) revisions webpage is designed to assist you with loan delivery requirement revisions to ULDD since the publication of the last Appendices A and D on September 12, 2023. These revisions include ULDD specification updates and ULDD impacts that have been previously communicated in the Single-Family Seller/Servicer Guide (Guide) Bulletins.

The information on this webpage will be removed once the revisions have been incorporated into Appendices A and D.

The ULDD revisions are listed in the tables below. These tables identify the communication date and Guide Bulletin number if applicable, Sort ID, Data Point Name, Revision Effective Date, a description of the change, and the ULDD column(s) that have been revised (text being removed will be displayed in red strikethrough, text being added will be displayed in blue).

Revised ULDD Data Points

Toggle all accordion sections
  • November 6, 2024

    November 6, 2024 – Bulletin #2024-15

    Sort IDData Point NameRevision Effective Date Revision DescriptionRevision for FRE Implementation Notes

    293

    		Refinance Cash Out Amount

    November 6, 2024

    		Guide Section update for GreenCHOICE Mortgages®.
    • Format: Enter as a positive number.
    • Values:
      • Enter the Note Amount (Sort ID 319) minus the following amounts paid with the proceeds of the refinanced Mortgage:
        • Existing first lien (including prepayment penalty)
        • The amount paid on any subordinate liens secured by the Mortgaged Premises that were used in their entirety to purchase the subject property
        • Closing Costs
        • The outstanding balance of a land contract or contract for deed, per the requirements of Guide Section 4404.1
        • A Property Assessed Clean Energy (PACE) or PACE-like obligation, per the requirements of Guide Section 4301.8
        • For GreenCHOICE Mortgages®, the eligible improvements, per the requirements of Guide Sections 4606.1(bc) and 4606.34
        • For CHOICERenovation® Mortgages, the eligible renovations per the requirements of Guide Sections 4607.6 and 4607.7(c)

    244.1

    		Energy Improvement Amount

    November 6, 2024

    		Guide Section update for GreenCHOICE Mortgages®.

    Values:

    • Enter the cost of the eligible improvements as described in Guide Section 4606.1(bc) or the amount to pay an Existing Debt (as defined in Guide Section 4606.1(ca)).
    • The amount entered must be greater than "0" (zero).
  • October 2, 2024 – Revision 1

    October 2, 2024 - Bulletin #2024-13

    Sort ID

    Data Point Name 

    Revision Effective Date

    Revision Description

    Revision for FRE Implementation Notes

    293

    		Refinance Cash Out Amount

    October 2, 2024

    		Updated Implementation Notes with Guide Section update for CHOICERenovation® Mortgages.
    • Format: Enter as a positive number.
    • Values:
      • Enter the Note Amount (Sort ID 319) minus the following amounts paid with the proceeds of the refinanced Mortgage:
        • Existing first lien (including prepayment penalty)
        • The amount paid on any subordinate liens secured by the Mortgaged Premises that were used in their entirety to purchase the subject property
        • Closing Costs
        • The outstanding balance of a land contract or contract for deed, per the requirements of Guide Section 4404.1
        • A Property Assessed Clean Energy (PACE) or PACE-like obligation, per the requirements of Guide Section 4301.8
        • For GreenCHOICE Mortgages®, the eligible improvements, per the requirements of Guide Sections 4606.1(c) and 4606.4
        • For CHOICERenovation® Mortgages, the eligible renovations per the requirements of Guide Sections 4607.6 and 4607.78(cb)

    311

    		Price Lock DatetimeOctober 2, 2024Removed additional Implementation Notes to align with guidance for the HMDA regulation.

    Values:

    • Enter the date on which the interest rate reflected on the note was locked with the Borrower.
    • If the lock date is extended, and the extension results in a change to the interest rate that was originally locked in, enter the date the price lock was extended.
    • Do not enter the date that the aggregator locked in the rate with the correspondent.
    • Enter only the date; the time will be ignored.
    • Enter the This value that corresponds with the Rate Set Date used in determining Sort ID 208-HMDARateSpreadPercent in accordance with the 2015 HMDA Final Rule.
  • October 2, 2024 – Revision 2

    October 2, 2024 - Bulletin #2024-13

    Sort IDData Point NameRevision Effective Date Revision DescriptionRevision for FRE Conditionality DetailsRevision for FRE-Supported Enumerations
    193.1Alterations Improvements And Repairs Amount

    March 31, 2025

    Updated Conditionality Details:

    • Added CHOICE Renovation In Progress
    • Removed CHOICE Renovation Mortgage With Recourse
       
    		IF Sort ID Sort ID 404-LoanProgramIdentifier = “CHOICERenovation”, “CHOICERenoEXpress”, “CHOICERenoEXpressDTSArea”OR
    "CHOICERenovationInProgress" 
    “CHOICERenovationMortgageWithRecourse”    		 
    404Loan Program Identifier

    March 31, 2025

    		Added Enumeration – CHOICE Renovation In Progress and removed Enumeration – CHOICE Renovation Mortgage With RecourseIF appliesSee Tab 8-Enumerations
    CHOICERenovationInProgress
    CHOICERenovationMortgageWithRecourse
  • May 16, 2024

    May 16, 2024  - Loan Selling Advisor Announcement

    Sort IDData Point NameRevision Effective Date Revision DescriptionRevision for ULDDS FormatRevision for FRE FormatRevision for FRE Implementation Notes

    49.3

    		FRE Condo Project Advisor Project Assessment Request Identifier

    July 28, 2025

    		Updated Format to String 12.String 12
    Numeric 10    		String 12
    Numeric 10    		Format: Valid format is “PAR#########”
    Values: Enter the 'Project Assessment Results #' received on the Condo Project Advisor® Feedback Certificate.
     

    49.4

    		FRE Condo Project Advisor Project Waiver Request Identifier

    July 28, 2025

    		Updated Format to Numeric 8.Numeric 8 10Numeric 8 10Values: Enter the 'Condo Project Waiver Request #' received on the Condo Project Advisor® Feedback Certificate.
  • May 1, 2024

    May 1, 2024 - Bulletin #2024-6

    Sort IDData Point NameRevision Effective DateRevision DescriptionRevision for FRE Implementation Notes
    173Down Payment Source TypeMay 1, 2024Added Implementation Note for Originating Lender.

    Values: 

    If Down Payment data is provided, the data must include an amount, a supported source enumeration and a supported type enumeration.

    • If the gift or grant reported to Loan Product Advisor® (LPA) was applied to Down Payment, map the new LPA Funds Source enumerations as follows:
      • Map LPA "UnmarriedPartner" to ULDD "Relative"
    • Enter "OriginatingLender" for Mortgages originated with gifts and grants from the Seller.
    • If Down Payment data is provided, see Tab 12-Additional Implementation Notes.

    Enter "OriginatingLender" for all lender sources.

  • March 6, 2024

    March 6, 2024 - Bulletin #2024-3

    Sort IDData Point NameRevision Effective DateRevision DescriptionRevision for FRE Implementation NotesRevision for FRE-Supported Enumerations
    83Property Valuation AmountMarch 6, 2024Updated Implementation Notes.

    Values: 

    • If an appraisal has been obtained, enter the appraised value.
    • If Automated Collateral Evaluation (ACE) or ACE+ PDR was offered and accepted by the Seller, enter the Purchase Price for a purchase transaction or the estimated value used to underwrite the loan for a refinance transaction.
    • Enter the value that was used to calculate the LTV for the delivered loan.
    • Enter the value as instructed in Seller's negotiated terms as applicable.
    		 
    292Total Monthly Proposed Housing Expense AmountMarch 6, 2024Updated Implementation Notes for ARMs.

    Values:

    • Enter the sum of the monthly charges for all Borrowers' Primary Residences (regardless of property usage type) as described in Guide Section 5401.1. Round to the nearest dollar.
    • For ARMs, enter the monthly housing expense debt payment calculated using the monthly housing expense determined using the Mortgage payment the Borrower is making at the time the Seller delivers the Mortgage. Round to the nearest dollar.
    • For second home or Investment Property Mortgages, enter the housing expense for all Borrowers' Primary Residences, not the housing expense of the subject property. Round to the nearest dollar.
    • For subsidy buydown Mortgages, enter the monthly housing expense calculated using the Mortgage payment the Borrower is making at the time the Seller delivers the Mortgage. Round to the nearest dollar.
    • For financed permanent buydown Mortgages, calculate using the initial P&I payment amount at the permanently bought down Note Rate. Round to the nearest dollar.
       
    		 
    376Investor Collateral Program IdentifierSeptember 4, 2024Removed Enumeration - Property Inspection Alternative.

    Values:

    Enter "PropertyInspectionAlternative" OR "AutomatedCollateralEvaluation" OR "PropertyDataCollection" if assessed through Loan Product Advisor® (LPA) and permitted by LPA.
    Enter "PropertyInspectionWaiver" OR "ValueAcceptance" if permitted by Seller's negotiated term.

    		AutomatedCollateralEvaluation
    PropertyDataCollection
    PropertyInspectionAlternative
    PropertyInspectionWaiver
    ValueAcceptance
  • February 16, 2024 – Revision 1

    February 16, 2024 - Loan Selling Advisor Announcement

    Sort IDData Point Name Revision Effective Date Revision DescriptionRevision for FRE Conditionality Details

    77

    		Bedroom Count

    June 3, 2024

    		Updated Conditionality Details to include Sort ID 90 (Other Description) for Hybrid Appraisal.IF [(Sort ID 89-PropertyValuationMethodType = "FullAppraisal" OR Sort ID 90-PropertyValuationMethodTypeOtherDescription ="HybridAppraisal")] AND (Sort ID 69-PropertyUsageType = "Investment" OR Sort ID 57-FinancedUnitCount > "1")

    78

    		Property Dwelling Unit Eligible Rent Amount

    June 3, 2024

    		Updated Conditionality Details to include Sort ID 90 (Other Description) for Hybrid Appraisal.IF (Sort ID 89-PropertyValuationMethodType = "FullAppraisal" OR Sort ID 90-PropertyValuationMethodTypeOtherDescription = "HybridAppraisal") AND (Sort ID 69-PropertyUsageType = "Investment" OR Sort ID 57-FinancedUnitCount > "1")

    430.1

    		MI Interest Rate Adjustment Percent

    July 28, 2025

    		Updated Conditionality Details to require the data point when MI premium source is Lender and delivery for Investor when available.IF [(Sort ID 426-MIPremiumSourceType = "Lender" OR (Sort ID 427-MIPremiumSourceTypeOtherDescription = "Investor") AND Sort ID 430.2-MIPremiumPlanType = "Monthly"] OR [(Sort ID 430.2-MIPremiumPlanType = "Single" OR "Split") AND IF Available)]

    430.2

    		MI Premium Plan Type

    July 28, 2025

    		Updated Conditionality Details to require the data point when MI Certificate Identifier exists and delivery for Investor when available.IF Sort ID 412-MICertificateIdentifier exists OR (Sort ID  430 PrimaryMIAbsenceReasonTypeOtherDescription = "NoMIBasedOnInvestorRequirements"  427-MIPremiumSourceTypeOtherDescription = "Investor" AND IF Available)
  • February 16, 2024 – Revision 2

    February 16, 2024 - Loan Selling Advisor Announcement

    Sort IDData Point NameRevision Effective Date Revision DescriptionRevision for FRE Implementation Notes

    89

    		Property Valuation Method Type

    June 3, 2024

    		Added Hybrid Appraisal to the “Other” Implementation Note.

    Values: 
    Enter the FRE-Supported Enumeration for the method that yielded the value used to calculate the LTV for the delivered loan:

    • Enter "AutomatedValuationModel" for Home Value Explorer® (HVE).
      Enter “DesktopAppraisal” if a desktop appraisal was used to value the subject property.
    • Enter "DriveBy" if an exterior-only appraisal was used to value the subject property.
    • Enter "FullAppraisal" if an interior and exterior inspection appraisal was used to value the subject property. 
    • Enter "None" if an appraisal waiver was used to originate the Mortgage.
      Enter "Other" if a desk review, or field review, or hybrid appraisal was used to value the subject property.
    • Enter the values as instructed in Seller's negotiated terms for all other property valuation method types.
       

    598.1

    		Intent To Occupy Type

    July 28, 2025

    		Updated Implementation Notes to remove first-time homebuyer reference.

    Definition: The URLA section reference is 5a, About this Property and Your Money for this Loan.
    Values: 

    • Enter "Yes” if the  property will be occupied as the Borrower's is a first-time homebuyer of the primary residence, or if applies.
    • Enter "No” if the property will not be occupied as the Borrower’s primary residence.
  • December 6, 2023

    December 6, 2023 – Bulletin #2023-24

    Sort IDData Point NameRevision Effective DateRevision DescriptionRevision for FRE Implementation Notes

    42

    		Project Classification Identifier

    December 8, 2023

    		Updated note in Additional Implementation Notes.Enter “ExemptFromReview” for Freddie Mac-owned “no cash-out” refinance Condominium Unit Mortgages, Refi Possible® Mortgages, Mortgages secured by Detached Condominium Units, or by Condominium Units in 2- to 4- Unit Condominium Projects, OR if applies. See Guide Section 5701.7 or 5701.10.

    244.1

    		Energy Improvement Amount

    December 6, 2023

    		Updated Implementation Notes.

    Values: 

    • Enter the cost of the  energy efficiency eligible improvements as described in Guide Section 4606.1(c) or the amount to payoff energy efficiency an Existing dDebt (as defined in Guide Section 4606.1(a)).
    • The amount entered must be greater than "0" (zero).

    293

    		Refinance Cash Out Amount

    December 6, 2023

    		Added additional Guide sections for GreenCHOICE Mortgages® and CHOICERenovation® Mortgages.

    Format: Enter as a positive number.
    Values: 

    • Enter the Note Amount (Sort ID 319) minus the following amounts paid with the proceeds of the refinanced Mortgage:
      • Existing first lien (including prepayment penalty)
      • The amount paid on any subordinate liens secured by the Mortgaged Premises that were used in their entirety to purchase the subject property
      • Closing Costs 
      • The outstanding balance of a land contract or contract for deed, per the requirements of Guide Section 4404.1
      • A Property Assessed Clean Energy (PACE) or PACE-like obligation, per the requirements of Guide Section 4301.8
      • For GreenCHOICE Mortgages® Tthe eligible energy and/or water efficiency improvements, per the requirements of Guide Sections 4606.1(c) and 4606.4
      • For CHOICERenovation®SM Mortgages, the eligible renovations per the requirements of Guide Sections 4607.6 and 4607.8(b)

    363

    		Escrow Balance Amount

    December 6, 2023

    		Updated Implementation Notes for GreenCHOICE Mortgages®.

    Values:

    • For Mortgages with Escrow accounts sold through Cash-Released XChangeSM, enter the Escrow balance amount.
    • For Concurrent Transfer of Servicing (CTOS) Mortgages with Escrow accounts, enter the Escrow balance amount. 
    • For GreenCHOICE Mortgages®SM, enter the Escrow balance amount sufficient to cover the cost of the eligible energy and/or water efficiency improvements.
     
  • October 4, 2023

    October 4, 2023 - Bulletin #2023-19

    Sort IDData Point NameRevision Effective DateRevision DescriptionRevision for FRE Implementation Notes

    290

    		Total Liabilities Monthly Payment Amount

    October 4, 2023

    		Added Implementation Notes for ARMs.

    Values: 

    • Enter the monthly debt payment as defined in Guide Section 5401.2. Round to the nearest dollar.
    • For ARMs, enter the monthly debt payment calculated using the monthly housing expense determined using the Mortgage payment the Borrower is making at the time the Seller delivers the Mortgage. Round to the nearest dollar.
    • For subsidy buydown Mortgages, enter the monthly debt payment calculated using the monthly housing expense determined using the Mortgage payment the Borrower is making at the time the Seller delivers the Mortgage. Round to the nearest dollar.
    • For Mortgages for which the Borrower uses credit card, cash advance, or unsecured line of credit to pay fees, enter the monthly debt payment as defined in Guide Section 5401.2, including the amount charged or advanced when it is included in the Borrower's total outstanding debt. Round to the nearest dollar.

    292

    		Total Monthly Proposed Housing Expense Amount

    October 4, 2023

    		Added Implementation Notes for ARMs.

    Values: 

    • Enter the sum of the monthly charges for all Borrowers' Primary Residences (regardless of property usage type) as described in Guide Section 5401.1. Round to the nearest dollar.
    • For ARMs, enter the monthly debt payment calculated using the monthly housing expense determined using the Mortgage payment the Borrower is making at the time the Seller delivers the Mortgage. Round to the nearest dollar.
    • For second home or Investment Property Mortgages, enter the housing expense for all Borrowers' Primary Residences, not the housing expense of the subject property. Round to the nearest dollar.
    • For subsidy buydown Mortgages, enter the monthly housing expense calculated using the Mortgage payment the Borrower is making at the time the Seller delivers the Mortgage. Round to the nearest dollar.
    • For financed permanent buydown Mortgages, calculate using the initial P&I payment amount at the permanently bought down Note Rate. Round to the nearest dollar.
     

This information is not a replacement or substitute for the requirements in the Freddie Mac Single-Family Seller/Servicer Guide or any other contractual agreements. This information does not constitute an agreement between Freddie Mac and any other party. © 2024 Freddie Mac.

Subscription Center

Get and stay connected with Freddie Mac Single-Family. Subscribe to our emails and we'll send the information that you want straight to your email inbox.

Sign Up