imminent default indicator™ - freddie mac is in danger of imminent default. idi will use the data...
TRANSCRIPT
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
1
Imminent Default Indicator™ Technical Specifications
Version 1.7
January 2010
NOTICE This manual is the property of Freddie Mac. The manual includes confidential information and trade secrets, which have been developed or acquired by Freddie Mac through the expenditure of a significant amount of time and financial resources. As a condition to receipt of this manual, the recipient of the manual agrees to maintain and protect the confidentiality of the manual and the contents hereof and not to disclose or use any portion of the manual for any purpose other than to the extent necessary to perform services for Freddie Mac.
Copyright 2009 Freddie Mac
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
2
TABLE OF CONTENTS
Introduction
Purpose 3 Overview 3
Section II
Input File 4 Section III
Output File 6 Section IV
Imminent Default Indicator Errors 7 Error Recording Process 7
Appendix A 9
Appendix B 17
Appendix C 19
Appendix D 21
Appendix E 23
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
3
PURPOSE
This document provides information for data input and output specifications for Freddie Mac’s Imminent Default Indicator (IDI). The purpose of this document is to assist customer developers in creating a functioning environment for load data to IDI. The customer will learn considerations to be made for each loan when the data Input file is created into the environment, understand the field content and sequence from the Output file and understand the error handling and messages that will be provided.
OVERVIEW
Imminent Default Indicator is a software application that utilizes statistical models in conjunction with specific data elements submitted by the Servicer to determine whether a Borrower is in danger of imminent default. IDI will use the data Input file containing borrower, mortgage and property information along with current economic data to calculate an Imminent Default Indicator result for each loan.
The Input File section covers actions to consider when creating and assembling an Input file. The Output File section describes the content and sequence produced by IDI model. The Imminent Default Indicator Errors section covers the error recording process and provides a brief description of the steps used by IDI to check input files for errors. This section also includes a decision tree to graphically describe the process.
APPENDIX A: Input File Field Definitions APPENDIX B: Output File Field Definitions
APPENDIX C: Fatal Global Record Errors APPENDIX D: Fatal Imminent Default Record Errors
APPENDIX E: Non-Fatal Imminent Default Record Errors
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
4
Section II - Input File
The Imminent Default Indicator Input file is a data file that contains loan data and is used, along with current economic data, to calculate an IDI result for each loan. The file contains a total of 72 variables or fields of data (29 of which are mandatory), is in comma separated value (*.csv) format, has a *.csv extension, and contains a record—a separate line of data—for each loan to be scored.
Servicers must provide an Input file format that contains space for all 72 fields and may either populate all 72 fields with the appropriate values, or provide data for the 29 required fields and populate the other fields with commas as null values. Since this is a .csv format, an actual value is not necessary and entering a comma will fulfill the requirement. Early Indicator® users may use their existing 72 field Early Indicator Input file (with the exception of the update to field #28 – ServicerID, see: Appendix A).
When creating and assembling an Input file the following should be considered:
• Apostrophes and Quotation Marks
IDI does not accept apostrophes as inputs. Quotation marks may be rejected; therefore, it is recommended not to insert quotation marks.
• File Naming Convention
File name must not have spaces or special characters; exception: can use dash (“-“) and underscore (“_”). “IDI” may not be in the file name.
• Zip Files:
IDI does not accept Zip files.
• Leading Zeroes
In order to capture leading zeroes in the PropZip field (Field #13), this field should be set to “text” in the Input file.
• Maximum File Size:
The Input file should contain a maximum of 23,000 records.
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
5
Section II - Input File - Continued
• Default Values and Missing Data
For fields that have default values, those values are indicated in the Default column in the chart provided below. If you have reliable data for fields that you are providing, always use this data to populate a given field. If any data is missing, do not code the default value into your data extract program that creates the Input file. Default values may change over time. By relying on the IDI model to calculate values, there is no need to make changes to your extract program. Keep in mind that when a default value is used in lieu of the actual data, the loan may be scored and it may also receive a Non-Fatal Imminent Default Record Error (300 series error). Should you receive one of these errors, please verify that you do not have actual data to be used in place of the default value.
The model contains mandatory fields. If a mandatory field does not have a default value, the model will attempt to score a loan using the information that is provided. In some cases, the model may not be able to produce a result and will return a Fatal Global Record Error (100 series error), or Fatal Imminent Default Record Error (200 series error)
• Fields Reserved for Future Use
Please note that some fields are designated as “Reserved for Future Use: If you are populating any of these fields, you will need to adjust your Input file format; however, you will still need a comma as a null value.
The Appendix A chart presents the 72 fields to be included in the Input file.
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
6
Section III - Output File
Imminent Default Indicator produces an Output file that contains 30 fields of data: the Lender Loan Number, the IDI result, and error codes for each loan. The file is in comma separated value (*.csv) format, has an *.csv extension, and contains a record for each scored loan. The Output file also contains a header line – the first line of the Output file – containing the ‘Field Name’ value below for each of the fields. The field content and sequence are defined in Appendix B.
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
7
Section IV – Imminent Default Indicator Errors
• Imminent Default Indicator Error Types
Error types include:
• Fatal Global Record Errors (100 series errors)
• Fatal Imminent Default Record Errors (200 series errors)
• Non-Fatal Imminent Default Record Errors (300 series errors)
NOTE: All Input files having fatal global or fatal model record errors must be reprocessed after the errors are resolved in order for the unscored loans to receive results.
Appendixes C-E describes the cause, consequence and resolution of each error.
• Error Recording Process
The following error detection process assumes records have been entered into the Input file and IDI has been started. When processing is complete, all errors can be viewed in the Output file.
• Records are processed and checked for Fatal Global Record Level errors.
• If a Fatal Global Record Level error occurs, the record is not scored and is sent to the Output file with the error code.
• If no Fatal Global Record Level errors occur, the record is checked for Imminent Default Model Level errors.
• If a model level error occurs and it is
• Fatal, the record is not scored and sent to the Output file with the fatal error code.
• Non-fatal, the record is scored and sent to the Output file with the non-fatal error code.
IMPORTANT: Multiple fatal errors may be reported on a loan.
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
8
Error Recording Decision Tree
These records are not scored, error codes are included in the
Output File.
These records are not scored, error codes are included in the
Output File.
Input File
Do the records contain any fatal
global record level errors?
Do the records contain model level fatal
errors?
Do the records contain model level non-fatal errors?
Output File
No
No
No
Yes
These records are scored, error codes are included in the
Output File.Yes
Yes
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
9
Appendix A - Input File Field Definitions
The following chart presents the 72 fields comprising the Input file:
#
Field Name
Description
Value Range/ Enumeration
Example
Default Mandatory
1. LndrLoanNm Lender Loan Number
Lender defined 23-09879, KJ234, 1234567890
None Yes
2. TapeDate Closing or system date on which the file was created
Ccyymmdd 20040213 Yes
3. OrigLoanNoteAmt Original loan note amount
$1–$9,999,999 1, 35000, 102000, 9999999
None Yes
4. CurAmt Current unpaid principal balance (UPB) on loan
$1–$9,999,999 1, 35000, 102000, 9999999
None Yes
5. FirstorSecond First or second mortgage indicator
1 = First mortgage
1 1
6. SubprimeFlag Indicates whether or not the loan is a subprime mortgage
0 = Not a subprime mortgage
0 0
7. BnkRptChp Current Bankruptcy Chapter: Indicates whether or not a loan is currently in bankruptcy and, if so, provides the Chapter
0 = Not currently in bankruptcy
7 = Currently in Chapter 7 bankruptcy
11 = Currently in Chapter 11 bankruptcy
12 = Currently in Chapter 12 bankruptcy
13 = Currently in Chapter 13 bankruptcy
99 = Currently in other or unknown chapter of bankruptcy
0, 7, 11, 12, 13, 99
0 Yes
8. CurrFcloseFlg Current foreclosure flag indicating if loan is an active foreclosure. Do not include if foreclosure has ended.
0 = No
1 = Yes
0, 1 0 Yes
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
10
#
Field Name
Description
Value Range/ Enumeration
Example
Default Mandatory
9. LoanPurp Purpose of loan
1 = Purchase
2 = Refinance, non-cash out 3 = Refinance, cash out 9 = Missing or invalid
1, 2, 3, 9 1
(Used for null value or if value of 9 is entered in this field.)
Yes
10. OrigApprAmt Original property appraised value amount
$1–$9,999,999 1, 35000, 102000, 9999999
None
11. OrigSalesAmt Original property sales price amount
$1–$9,999,999
In the case of a refinance, leave blank
1, 35000, 102000, 9999999
None
12. PropState Property state code Valid state code as recognized by the U.S. Postal Service for the 50 states, Washington D.C., Puerto Rico, the US Virgin Islands and Guam
CA, IA, NY, WI, DC, PR, VI, GU
None Yes
13. PropZip Property zip code Valid 5- or 9-digit zip code as recognized by the U.S. Postal Service
Important: If zip code is 9 digits, IDI requires a hyphen (-) in the 6th position
00768, 53118, 20007-1813
Field needs to be input as text
None
Yes
14. PropType Indicates the type of property
01 = Manufactured Home
04 = Condo - include apartment condos
08 = Mobile Home
09 = PUD - including de minimis (condos)
13 = Cooperative
14 = Single-family residence (detached)
15 = 2– to 4-unit (includes duplex, twin home, etc.)
16 = Townhouse (row house) UN = Unknown or invalid
01, 04, 08, 09, 13, 14, 15, 16, UN
14 (used in place of null values or when value in field is UN)
15. OrigTerm Original amortization term of loan in months
12–480 60, 120, 360
None
16. AssumptionDate For FHA/VA loans, date the loan was assumed by the current borrower
Ccyymmdd 19970604, 20040101
None
17. AcquisitionDate Date Servicer acquired servicing rights to this loan
Ccyymmdd 19970505, 20040101
None
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
11
#
Field Name
Description
Value Range/ Enumeration
Example
Default Mandatory
18. DelReason Delinquency reason
001 = Death of principal mortgagor
002 = Illness of principal mortgagor
003 = Illness of mortgagor's family member
004 = Death of mortgagor's family member
005 = Marital difficulties
006 = Income curtailment
007 = Excessive obligations
008 = Abandonment of property
009 = Distant employment transfer
011 = Property problem
012 = Inability to sell property
013 = Inability to rent property
014 = Military service
015 = Other
016 = Unemployment
017 = Business failure
019 = Casualty loss
022 = Energy-environment cost
023 = Servicing problems
026 = Payment adjustment
027 = Payment dispute
029 = Transfer of ownership pending
030 = Fraud
031 = Unable to contact borrower
INC = Incarceration
Caution: If delinquency reason is not available, leave field blank—do not populate using 015.
003, 013, 014, 029
None
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
12
#
Field Name
Description
Value Range/ Enumeration
Example
Default Mandatory
19. InvCode Investor Code 1 = FNMA
2 = FHLMC
3 = GNMA
4 = Private
5 = Warehouse
6 = Portfolio
1, 2, 3, 4, 5, 6
None Yes
20. SelfEmplyFlg Self-employed at time of origination
0 = No
1 = Yes
0, 1 0
21. OccupCode Occupancy status at origination
1 = Primary residence
2 = Second home
3 = Investor
1, 2, 3 1 Yes
22. DueForDate Due For Date—Date next payment is due; i.e., 1st payment due date in current spell of delinquency where corresponding payment has not been received
Ccyymmdd 1st of month: 19970601, 20040101
Odd due date: 20030917, 20040120
None Yes
23. OrigDate Date loan was originated
Ccyymmdd 19930227, 20040123
None Yes
24. NumUnits Number of units 1–4
Note: The software will not score loans where NumUnits >4, since these loans are assumed to be multifamily.
1, 2, 3, 4 Default value = 1 unless PropType= 15, where default value = 2
Yes
25. ProductType Product type 1 = Fixed 0–20
2 = Fixed > 20
3 = GPMs or TPMs
4 = Adjustable Rate Mortgage
5 = Balloons - maturity up to 5 years
6 = Balloons - maturity > 5 years
1, 2, 3, 4, 5, 6
2 Yes
26. NegAmFlg Potential negative amortization
0 = No
1 = Yes
0, 1 0
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
13
#
Field Name
Description
Value Range/ Enumeration
Example
Default Mandatory
27. LoanType Type of loan
1 = Conventional
2 = Conventional with MI
3 = FHA
4 = VA
1, 2, 3, 4 1 Yes
28. ServicerID For Freddie Mac this is the 6 digit Seller/Servicer # (not family number).
Investor defined
123456, None Yes
29. Reserved for Future Use
30. HighRiskAltA Indicates whether or not a loan is High Risk Alt-A or not. High Risk Alt-A is equivalent to a PLS, low doc Alt-A loan.
0 = Not high risk Alt-A
1 = High risk Alt-A
0, 1 0 Yes
31. Current DebtToIncomeRatio
Debt to Income Ratio = (Total Monthly Debt Obligations) / (Monthly Income)
If Monthly Income = 0 or is Null OR Total Monthly Debt Obligations is Null, then set DebtToIncomeRatio = Null
Valid values = greater than 0 and less than 1.20
Important: Enter the value as a ratio (e.g., 0.257); do not enter the value in percentage terms (e.g., 25.7)
Use:
0.257, 0.375, 1.20
Do not use:
25.7, 37.5, 120
0.40 Yes
32. CurrOccupStatusCode
Current Occupancy Status
01 = Vacant
03 = Borrower Occupied
04 = Tenant Occupied
06 = Unknown
15 = Occupied by Unknown
01, 03, 04, 06, 15
None
33. RepaymentPlan Indicates if a repayment agreement is in effect
0 = No
1 = Yes
0, 1 0
34 SubprimeRiskGrade Value assigned by loan underwriter/Servicer
(This field is not currently used by IDI and may be used in a future release.)
35. LoanMod Indicates if the terms of the loan have been previously modified
0 = No
1 = Yes
0, 1 0 Yes
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
14
#
Field Name
Description
Value Range/ Enumeration
Example
Default Mandatory
36. OrigLTV
Original Loan-to-Value
When computing original loan-to-value for conventional purchases, use the lesser of Appraisal Value or Sales Amount and round up the LTV calculation to the 2nd decimal place.
2–125
Important: Enter the value as a percentage (e.g., 25.75); do not enter the value as a ratio (e.g., 0.257)
Use: 71.22
Do not use: 71.223
None Yes
37. EstCurVal Estimated current market value
$1,000–$9,999,999 1000, 83000, 125000, 9999999
None Yes
38. InvLoanNum Investor Loan Number – represents loan number assigned by Investor identified in Investor Code field number 19
Investor defined 1234567890, 555444666111, 8945688
None Yes
39. PayDue1 Payment history due date (begin with most recent month, regardless of delinquency)
ccyymmdd 20030501 None
40. PayRec1 Payment history received date
Ccyymmdd 20030512 None
41. PayDue2 Payment history due date
ccyymmdd 20030401 None
42. PayRec2 Payment history received date
ccyymmdd 20030409 None
43.
PayDue3 Payment history due date
ccyymmdd 20030301 None
44.
PayRec3 Payment history received date
ccyymmdd 20030305 None
45.
PayDue4 Payment history due date
ccyymmdd 20030201 None
46.
PayRec4 Payment history received date
ccyymmdd 20030212 None
47.
PayDue5 Payment history due date
ccyymmdd 20030101 None
48.
PayRec5 Payment history received date
ccyymmdd 20030111 None
49.
PayDue6 Payment history due date
ccyymmdd 20021201 None
50.
PayRec6 Payment history received date
ccyymmdd 20021220 None
51.
PayDue7 Payment history due date
ccyymmdd 20021101 None
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
15
#
Field Name
Description
Value Range/ Enumeration
Example
Default Mandatory
52.
PayRec7 Payment history received date
ccyymmdd 20021105 None
53.
PayDue8 Payment history due date
ccyymmdd 20021001 None
54.
PayRec8 Payment history received date
ccyymmdd 20021010 None
55.
PayDue9 Payment history due date
ccyymmdd 20020901 None
56. PayRec9 Payment history received date
ccyymmdd 20020908 None
57. PayDue10 Payment history due date
ccyymmdd 20020801 None
58. PayRec10 Payment history received date
ccyymmdd 20020807 None
59. PayDue11 Payment history due date
ccyymmdd 20020701 None
60. PayRec11 Payment history received date
ccyymmdd 20020710 None
61. PayDue12 Payment history due date
ccyymmdd 20020601 None
62. PayRec12 Payment history received date
ccyymmdd 20020605 None
63. Times30 Number of times 30 days past due (2 payments missed) in the last 9 months
This field is not required if payment history (fields 39–62) is provided.
0–9 1, 9 None Yes
64. Times60 Number of times 60 days past due (3 payments missed) in the last 9 months
This field is not required if payment history (fields 39–62) is provided.
0–9 1, 9 None Yes
65. Times90 Number of times 90 or more days past due (4 or more payments missed) in the last 9 months
This field is not required if payment history (fields 39–62) is provided.
0–9 1, 9 None Yes
66. NumBorrower Number of borrowers on mortgage
1 = 1
2 = 2
3 = 3 or more
1, 2, 3 1
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
16
#
Field Name
Description
Value Range/ Enumeration
Example
Default Mandatory
67. OrigNoteRate Original note rate—interest rate (in percentage term) on loan at the time of origination
1–25
Important: Enter the value as a percentage (e.g., 25.7); do not enter the value as a ratio (e.g., 0.257)
Use: 7.25, 8.35, 11.6
Do not use: .0725 or 725
None
68. CurrNoteRate Current note rate—current interest rate (in percentage term) on loan
1–25
Important: Enter the value as a percentage (e.g., 25.7); do not enter the value as a ratio (e.g., 0.257)
Use: 7.25, 8.35, 11.6
Do not use:
.0725 or 725
None
69. MatureDate Date last payment would be made assuming no prepayments
ccyymmdd 20130227 None
70. FcloseHistFlag Loan has been in foreclosure in the past and is not currently in foreclosure; or loan is currently in foreclosure and has been in one or more foreclosures in a different spell in the past
0 = No to both
1 = Yes to either
0, 1 0 Yes
71. CreditScore Credit score:
CreditInd (field 72) must be provided
350-950 350, 567, 765, 950
None Yes
72. CreditInd Credit indicator 1 = FICO 1 None Yes
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
17
Appendix B - Output File Field Definitions
# Field Name Description Value Range / Enumeration
Example
1 LOAN_NUMBER Lender Loan Number Lender defined 23-09879, KJ234, 1234567890
2 IDI_RESULT Imminent Default Indicator Result Blank, 1, 2 1,2
3 Err101 Invalid token count 0, 101 0,101
4 Err102 Missing lender loan number 0, 102 0,102
5 Err103 Missing or invalid tape date 0, 103 0,103
6 Err104 Missing or invalid due for date 0, 104 0,104
7 Err106 Model has expired 0, 106 0,106
8 Err107 Criteria not met for imminent default scoring 0, 107 0,107
9 Err201 Missing or invalid origination date 0, 201 0,201
10 Err203 Missing or invalid property state and property zip code
0, 203 0,203
11 Err204 Unable to calculate current LTV 0, 204 0,204
12 Err210 Number of units is greater than 4 0, 210 0, 210
13 Err211 Unable to calculate mark-to-market LTV 0, 211 0, 211
14 Err212 Current amount missing or invalid 0, 212 0, 212
15 Err215 Invalid current LTV 0, 215 0, 215
16 Err302 Missing, invalid or unrecognized property zip code, default used
0, 302 0, 302
17 Err303 Missing or invalid property state, default used
0, 303 0, 303
18 Err305 Missing or invalid loan purpose, default used
0, 305 0, 305
19 Err315 Missing or invalid current occupancy code, default used
0, 315 0, 315
20 Err316 Missing or invalid loan type, default used 0, 316 0, 316
21 Err318 Inconsistent property state and property zip code
0, 318 0, 318
22 Err320 Warning! – Model will expire if software is not updated
0, 320 0, 320
23 Err321 Missing or invalid chapter of bankruptcy, default used
0, 321 0, 321
24 Err322 Missing or invalid original LTV 0, 322 0, 322
25 Err326 Missing or invalid debt to income ratio, default used
0, 326 0, 326
26 Err334 Missing or invalid product type, default used 0, 334 0, 334
27 Err337 Missing or invalid number of units, default used
0, 337 0, 337
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
18
# Field Name Description Value Range / Enumeration
Example
28 Err340 Payment history not usable 0, 340 0, 340
29 Err344 Missing or invalid foreclosure history flag, default used
0, 344 0, 344
30 Err349 Missing or invalid loan modification flag, default used
0, 349 0, 349
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
19
Appendix C - Fatal Global Record Errors
101 Invalid token count
Cause The data record format is not consistent with the required format, i.e., an incorrect number of fields were detected.
Consequences Record not scored.
Resolution Check the number of fields and commas. Modify the record to be consistent with the layout requirements. See Imminent Default Indicator – Input File Definition document.
102 Missing lender loan number
Cause Lender loan number is missing from record.
Consequences Record not scored.
Resolution Enter lender loan number in Input file. See Imminent Default Indicator – Input File Definition field 1.
103 Missing or invalid tape date
Cause Closing tape date (when the file was created) is missing, invalid or in an incorrect format.
Consequences Record not scored.
Resolution Enter proper tape date in Input file. See Imminent Default Indicator – Input File Definition field 2.
104 Missing or invalid due for date
Cause Due for date (1st payment due date in current spell of delinquency where
corresponding payment has not yet been received) is missing, invalid, in an incorrect format, or is nine or more years prior to the tape date.
Consequences Record not scored.
Resolution Enter proper due for date in Input file. See Imminent Default Indicator – Input File Definition field 22.
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
20
106 Model has expired–contact Freddie Mac for a software update
Cause The software is more than 210 days old from the beginning of the quarter and has expired.
Consequences Record not scored.
Resolution Contact Imminent Default Indicator Technical Support at 800-FREDDIE (800-373-3343).
107 Criteria not met for Imminent Default scoring
Cause The loan is not scored using the imminent default model because the loan doesn’t meet certain criteria for scoring.
Consequences Record not scored.
Resolution The following must be satisfied for loans that are less than 30 days past due.
Subprime flag = 0 Loan type = (1,2) Lien position = 1 Current foreclosure status = 0 Availability of a credit score = 1 Number of payments past due = (0,1) Investor code = 1,2 Valid Investor Loan number entered for input field 38
If the loan does not meet these criteria, and it is due for (0,1) payment, then it will receive an error code of 107.
The following must be satisfied for loans that are greater than or equal to 30, but less than 60 days past due.
Subprime flag = 0 Loan type = (1,2) Lien position = 1 Current foreclosure status = 0 Availability of a credit score = 1 Number of payments past due = 2 Investor code = 1,2 Valid Investor Loan number entered for input field 38
If the loan does not meet these criteria, and it is due for 2 payments, then it will receive an error code of 107.
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
21
Appendix D - Fatal Imminent Default Record Errors
201 Missing or invalid origination date
Cause The origination date field contains an invalid origination date, an incorrectly formatted date, a date either 35 or more years before the tape date or after the due for date entered in field 22, or the field is blank.
Consequences Record not scored.
Resolution Enter proper date of origination. See Imminent Default Indicator – Input File Definition fields 2, 22 and 23.
203 Missing or invalid property state and property zip code
Cause An invalid state abbreviation was entered in the property state field or the field is blank, and an invalid zip code was entered in the property zip code field or the field is blank.
Consequences Record not scored.
Resolution Enter proper state abbreviation. IDI recognizes the United States Postal Service (USPS) two-letter abbreviations for all 50 states, DC (Washington DC), PR (Puerto Rico), GU (Guam) and VI (U.S. Virgin Islands). See Imminent Default Indicator – Input File Definition field 12.
Enter proper zip code. IDI recognizes valid USPS 5- or 9-digit zip codes. If a 9-digit zip code is provided, a hyphen is required in the 6
th position. See
Imminent Default Indicator – Input File Definition field 13.
204 Unable to calculate current LTV
Cause The components necessary to calculate the current LTV are missing, and the appraisal-based LTV either cannot be calculated or, if calculated, is too low (less than 1).
Consequences Record not scored.
Resolution Check the original loan note amount (field 3), current loan amount (field 4), original appraisal amount (field 10), original sales price (field 11), and original LTV (field 36) as outlined in the Imminent Default Indicator – Input File Definition document.
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
22
210 Number of units is greater than 4
Cause The entry made in the number of units field is greater than 4.
Consequences IDI cannot process multifamily-type properties, which are defined as those having more than four units. Record not scored.
Resolution Enter a valid number or remove multifamily-type properties from the Input file. See the Imminent Default Indicator - Input File Definition document, field 24.
211 Unable to calculate mark-to-market LTV
Cause Either the data necessary to calculate the mark-to-market LTV is missing or the calculated mark-to-market LTV is too low (less than 1).
Consequences Record not scored.
Resolution Verify that the input record is formatted according to the specifications outlined in the Imminent Default Indicator - Input File Definition document.
212 Current amount missing or invalid
Cause An invalid amount was entered into the current amount field or the field is blank.
Consequences Record not scored.
Resolution Enter proper amount. See the Imminent Default Indicator - Input File Definition document, field 4.
215 Invalid current LTV
Cause Calculated current LTV is too low (less than 1) and appraisal-based LTV either cannot be calculated or, if calculated, is too low (less than 1).
Consequences Record not scored.
Resolution Check the original loan note amount (field 3), current loan amount (field 4), original appraisal amount (field 10), original sales price (field 11), original LTV (field 36), and estimated current value (field 37) as outlined in the Imminent Default Indicator - Input File Definition document.
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
23
Appendix E - Non-Fatal Imminent Default Record Errors
302 Missing, invalid or unrecognized property zip code, default used
Cause An invalid zip code or a zip code not recognized by the software was entered in the property zip code field or the field was blank.
Consequences Record scored with property state entered in Input file field 12; sent to Output file with a non-fatal error code. Optimal result may not have been achieved.
Resolution Enter proper 5- or 9-digit zip code. See the Imminent Default Indicator - Input File Definition document, field 13.
303 Missing or invalid property state, default used
Cause An invalid state abbreviation was entered in the property state field or the field was blank.
Consequences Record scored with state value derived from the property zip code; sent to Output file with a non-fatal error code. Optimal result may not have been achieved.
Resolution Enter proper state abbreviation. See the Imminent Default Indicator - Input File Definition document, field 12.
305 Missing or invalid loan purpose, default used
Cause An invalid value was entered in the loan purpose field or the field was blank.
Consequences Record scored with purchase used as loan purpose; sent to Output file with a non-fatal error code. Optimal result may not have been achieved.
Resolution Enter a valid loan purpose value. See the Imminent Default Indicator - Input File Definition document, field 9.
315 Missing or invalid current occupancy code, default used
Cause The code entered in the current occupancy status code field was invalid or the field was blank.
Consequences Record scored with the default assumption that the property is not vacant; sent to Output file with a non-fatal error code. Optimal result may not have been achieved.
Resolution Enter a valid code. See the Imminent Default Indicator - Input File Definition document, field 32.
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
24
316 Missing or invalid loan type, default used
Cause An invalid value was entered in the loan type field or the field was blank.
Consequences Record scored with conventional loan without mortgage insurance being used; sent to Output file with a non-fatal error code. Optimal result may not have been achieved.
Resolution Enter a valid value. See the Imminent Default Indicator - Input File Definition document, field 27.
318 Inconsistent property state and property zip code
Cause The property state abbreviation entered in the property state field is not consistent with the zip code entered in the property zip code field.
Consequences Record scored with the property state entered, and the zip code information is disregarded; sent to Output file with a non-fatal error code. Optimal result may not have been achieved.
Resolution Check state and zip code. See the Imminent Default Indicator - Input File Definition document, fields 12 and 13.
320 Warning! – Model will expire if software is not updated
Cause The IDI software is more than 180 days old from the beginning of the quarter.
Consequences Record scored; sent to Output file with a non-fatal error code.
Resolution To ensure the resulting scores are accurate and reliable, contact IDI Technical Support at 800-FREDDIE (800-373-3343).
321 Missing or invalid chapter of bankruptcy, default used
Cause An invalid value was entered in the bankruptcy chapter field or the field was blank.
Consequences Record scored with borrower not in bankruptcy used; sent to Output file with a non-fatal error code. Optimal result may not have been achieved.
Resolution Enter a valid value. See the Imminent Default Indicator - Input File Definition document, field 7.
322 Missing or invalid original LTV
Cause An invalid value was entered in the original LTV field or the field was blank.
Consequences Record scored; sent to Output file with a non-fatal error code.
Resolution Enter a valid value. See the Imminent Default Indicator - Input File Definition document, field 36.
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
25
326 Missing or invalid debt to income ratio, default used
Cause The value entered in the debt to income ratio field is either too low (less than or equal to 0) or too high (greater than 1.20), or the field was blank.
Consequences Record scored with default ratio of 0.40 and sent to Output file with a non-fatal error code. Optimal result may not have been achieved.
Resolution Enter a valid code. See the Imminent Default Indicator - Input File Definition document, field 31.
334 Missing or invalid product type, default used
Cause An invalid value was entered in the product type field or the field was blank.
Consequences Record scored with single-family fixed rate 30 year product being used; sent to Output file with a non-fatal error code. Optimal result may not have been achieved.
Resolution Enter a valid code. See the Imminent Default Indicator - Input File Definition document, field 25.
337 Missing or invalid number of units, default used
Cause An invalid value was entered in the number of units field or the field was blank.
Consequences Record scored with default number of units and sent to Output file with a non-fatal error code. Optimal result may not have been achieved.
Resolution Enter a valid code. If PropType is not equal to 15, then NumUnits=1 is used. If PropType=15, then NumUnits=2 is used. See the Imminent Default Indicator - Input File Definition document, field 24.
340 Payment history not usable
Cause Invalid value(s) were entered in the payment history and Times30, Times60, and/or Times90 fields or the fields were blank.
Consequences Record scored as a new loan without a payment history; sent to Output file with a non-fatal error code. Optimal result may not have been achieved.
Resolution Enter valid values. See the Imminent Default Indicator - Input File Definition document, fields 39–62 and 63-65.
Freddie Mac Document Imminent Default Indicator v.1.7 Technical Specifications January 2010
26
344 Missing or invalid foreclosure history flag, default used
Cause An invalid value was entered in the foreclosure history flag field or the field was blank.
Consequences Record scored with no previous foreclosure being used; sent to Output file with a non-fatal error code. Optimal result may not have been achieved.
Resolution Enter a valid number in the foreclosure history flag field. See the Imminent Default Indicator - Input File Definition document, field 70.
349 Missing or invalid loan modification flag, default used
Cause An invalid value was entered in the loan modification field or the field was blank.
Consequences Record scored with loan not modified being used; record sent to Output file with a non-fatal error code. Optimal result may not have been achieved.
Resolution See the Imminent Default Indicator - Input File Definition document, field 35.