[Logo: Homes and Communities: U.S. Department of Housing and Urban Development]
[Vea la versión en español de esta página] [Contact Us] [Display the text version of this page] [Search/Index]
 

Housing
About Housing
Contact us
Keywords
 - Single Family
 - - Audience groups
 - - Buying a home
 - - Events & training
 - - FHA insured loans
 - - Common questions
 - - Housing counseling
 - - HUD homes/ REO
 - - Owning a home
 - - Reference guide
ORAMH
Hospitals
Multifamily
OAHP
Reading room
Online forums
Work online

HUD news

Homes

Resources

Communities

Working with HUD

Tools
Webcasts
Mailing lists
RSS Feeds
Help

[The U.S. government's official web portal]  

HECM Insurance Application

- -
 Information by State
 Print version
 

The HECM Insurance Application function allows an authorized lender to add, review, or change insurance application data for a HECM case. If a lender is not authorized to enter or update insurance application information, he/she may access the HECM Insurance Application function in Query mode.

The HECM Insurance Application function can be divided into five sections:

  1. Fundamental Case Information,
  2. General Information,
  3. Worksheet Information,
  4. Borrower Information, and
  5. Mortgage Information.

The listed information within the sections include borrower, property, loan, and credit information that is needed to process and insure the HECM case.



To run your application against pilot data, post your XML input file to:
https://hwvauwd491.hud.gov/b2b/chums/f17evcxml.cfm

To run your application against live data, post your XML input file to:
https://entp.hud.gov/b2b/chums/f17evcxml.cfm


History of Changes


Adding Support for recording HECM Counseling Certificates April 4 implementation
Added FHAVAHECMCounselCertificate element
Adding support for HECM Purchase, December 27 Implementation
Added new element, PurchasePriceAmount, to APPLICATION element
Added new element, FHAVARequiredInvestmentToClose, to FHAVA element
Origination Fees required, November 29, 2008 implementation
Required entry for cases originated on or after October 31, 2008
Added new element, OriginationFee, to PRODUCT element
FHAVAHECMmaximumClaimAmount will now accept input data, November 4, 2008 implementation
Adding Support for Appraiser Type, August 25, 2008 implementation
Added new attribute, Type, to FHAVAAppraiserLicenseIdentifier element
Added new element, LicenseType, to PARTY element
Type of license issued to appraiser. This field is optional unless the appraiser cannot be uniquely identified by state and license combination. If Type is omitted and the state and license combination is unable to uniquely identify the appraiser, this transaction will return an error message.

Valid values for the license type fields are Licensed, CertifiedGeneral, CertifiedResidential
Loan Transmittal, June 9, 2008 implementation. Changes will become mandatory on October 1 2008
Added new attribute to new element VALUATIONS, BuildingStatusType
Changes to FHAVA element, addition of 4 attributes related to correct ADP Code choice. Implementation date February 9, 2008
Amortization,
HousingProgram,
SpecialProgram,
BuyDown
LIBOR Changes, December 14 2007 Mandatory on this date.

Added FHAVAExpectedRateIndex element
Added ARMIndexType attribute to PRODUCT element
Consolidation of payment plan fields August 10, 2007 implementation

Dropped FHAVAHECMPaymentPlanTenure element
Dropped FHAVAHECMPaymentPlanTerm element
Dropped FHAVAHECMPaymentPlanLineOfCredit element
Added FHAVAHECMPaymentPlan element
ProcessLenderEndorsementStatus May 11, 2007 implementation

Added attribute ProcessLenderEndorsementStatus to MORTGAGEINSURANCE element
Borrower Verification June 18, 2005 implementation

All borrowers with SSNs will be validated.
A new control element (BorrowerValidationIndicator) is provided to override borrower validation when needed.
Added new element BorrowerValidationIndicator.
HECM Counseling April 2 implementation
Added new Attribute Value, CounselingAgency, to PartyType to report HECM Counseling Agency party detail information.
Added new element, FHAVAHECMCounselID.
Added new element, FHAVAHECMCounselDate.
HMDA Changes January 5 Implementation
Added APPLICATION attribute ApplicationMethod
Increased allowable number of borrowers to 5
Altered structure to read and report GOVERNMENTMONITORING data. Please check XML layout.
  1. Added GOVERNMENTMONITORING attribute, EthnicityType
  2. Added GOVERNMENTMONITORING attribute, BorrowerFurnished
  3. Dropped GOVERNMENTMONITORING attribute, RaceNationalOriginType
  4. Added element, RaceNationalOriginType
  5. Added RaceNationalOriginType attribute RaceNationalOriginTypeID
Added New attribute to APPLICATION element. <APPLICATION ApplicationMethod = ''>
Added <MortgageInsuranceCertificateToBeMailedToSponsor>
Retained (as deprecated) <MortgageInsuranceInformationToBeMailedToSponsor>
Flipping Changes October 18 implementation
Added <PROJECT PUDIndicator = '[Yes|No]'> to input.
Added <SUBJECTPROPERTY ManufacturedHomeIndicator = '[Yes|No]'>

XML File Layout

Key:

Only used on input Element/attribute is not produced by program output unless it is being returned due to an error condition.
Only used on output Element/attribute is returned by program but is not required or interpreted when the program is called.
Used on input and output May not always have exactly the same meaning on input an output though. Please consult the reference table from the linked data items for details.)
Deprecated Obsolete; all deprecated elements are supported but please use indicated element.
n Indicates a numeral, e.g., msg_n may be msg_1, msg_2, msg_3, etc.
Data Types
Integer Indicates a numeral
Alphanumeric Mixed Text (alphabetic, numeric and punctuation) Note: Some fields restrict some punctuation.
Numeric Formatted number, e.g. 999.99
String Specific keywords as indicated
Date A valid date, represented as YYYYMMDD

Return to CHUMS Origination Functions.

<?xml version='1.0' standalone='yes'?>
<MORTGAGEDATA MISMOVersionID='1.0.1'>
 <PROCESSSTATUS>
  <ProcessStatusRequestor>browser</ProcessStatusRequestor>
  <ProcessStatusCode>status_flag</ProcessStatusCode>
  <ProcessStatusMessage sCode="1">msg_n</ProcessStatusCode>
  <ProcessStatusFlag ProcessStatusFlagName = 'CLAS_DATA' ProcessStatusFlagValue = 'N' />
 </PROCESSSTATUS>
 <PROPERTY PROPERTYID = "1" PropertyType = "Subject">
  <Address2>prop_csz</Address2> 
  <City>addr_city_name</City>
  <County>addr_cnty_cd</County>
  <State>addr_ste_cd</State>
  <PostalCode>addr_zip_cd</PostalCode> 
  <PARSEDSTREETNAME>
   <HouseNumber>addr_hse_no</HouseNumber> 
   <DirectionPrefix>addr_pre_dir</DirectionPrefix> 
   <StreetName>addr_st_name</StreetName>
   <StreetSuffix>addr_st_tp</StreetSuffix>
   <DirectionSuffix>addr_post_dir</DirectionSuffix>
  </PARSEDSTREETNAME>
 </PROPERTY>
 <SUBJECTPROPERTY ManufacturedHomeIndicator = 'fac_fab'>
  <SubjectPropertyAppraisedValueAmount>prop_value</SubjectPropertyAppraisedValueAmount>
  <FinancedNumberOfUnits>living_units</FinancedNumberOfUnits>
 </SUBJECTPROPERTY>
 <APPLICATION ApplicationMethod = 'appl_method'>
  <AgencyCaseIdentifier>case_no</AgencyCaseIdentifier>
  <PurchasePriceAmount>sale_price</PurchasePriceAmount>
  <UNDERWRITINGCASE>
    <LoanScheduledClosingDate>closing_dt</LoanScheduledClosingDate>
    <FHAVA FHAVAADPCode='adp_code'
    Amortization ='adp_chara'
     HousingProgram ='adp_charh'
     SpecialProgram ='adp_chars'
     BuyDown ='adp_charb'>
     <FHAVAExpectedRateIndex>arm_eri</FHAVAExpectedRateIndex>
     <FHAVAProgramCodeIdentifier>program_id</FHAVAProgramCodeIdentifier>
     <FHAVAAppraiserLicenseIdentifier Type='appr_type'>appr_lic</FHAVAAppraiserLicenseIdentifier>
     <FHAVAOriginatorIdentifier>orig_id</FHAVAOriginatorIdentifier>
     <FHAVASponsorIdentifier>spnsr_id</FHAVASponsorIdentifier>
     <FHAVARepairEscrow
		 RepairEscrowAmount='amount'
		 RepairCompletedDate ='complete_dt'>
		 escrow
		 </FHAVARepairEscrow>
     <EstimatedFHAClosingCostsAmount>closing_costs</EstimatedFHAClosingCostsAmount>
     <FHAVAUndewriterApprovalDate>under_dt</FHAVAUndewriterApprovalDate>
     <FHAVARequiredInvestmentToClose>req_invst</FHAVARequiredInvestmentToClose>
     <FHAVAUnderwriterComputerizedHomesUnderwritingSystemIdentifier>
     under_id
     </FHAVAUnderwriterComputerizedHomesUnderwritingSystemIdentifier>
      <FHAVAHECM>
       <FHAVAHECMCounselID>counsel_tin</FHAVAHECMCounselID>
       <FHAVAHECMCounselCertificate>hecm_cert</FHAVAHECMCounselCertificate>
       <FHAVAHECMCounselDate>counsel_date</FHAVAHECMCounselDate>
       <FHAVAHECMExistingLiens>exist_liens</FHAVAHECMExistingLiens>
       <FHAVAHECMDebts>debts_non_re</FHAVAHECMDebts>
       <FHAVAHECMRealEstateDebts>re_debts</FHAVAHECMRealEstateDebts>
       <FHAVAHECMExpectedRate>exp_rate</FHAVAHECMExpectedRate>
       <FHAVAHECMARMFrequency>arm_type</FHAVAHECMARMFrequency>
       <FHAVAHECMMaximumInterest>cap</FHAVAHECMMaximumInterest>
       <FHAVAHECMPaymentPlan>payment</FHAVAHECMPaymentPlan>
       <FHAVAHECMPrincipalLimit>principal_limit</FHAVAHECMPrincipalLimit>
       <FHAVAHECMmaximumClaimAmount>max_claim_amt</FHAVAHECMmaximumClaimAmount>
      </FHAVAHECM>
     </FHAVA>
     </UNDERWRITINGCASE>
     <MORTGAGEINSURANCE
		ProcessLenderEndorsementStatus = 'lender_end'
		 MortgageInsurancePremiumFinancedIndicator = 'mip_financed'
		 MortgageInsuranceCertificateToBeMailedToSponsor = 'imail_to_spnsr'
		 MortgageInsuranceCertificateToBeIssuedInSponsorsName = 'issue_to_spnsr'/>
   </APPLICATION>
   <PROJECT PUDIndicator = 'pud_ind' />
   <INCOME>
    <IncomeAmount>monthly_income</IncomeAmount>
    <ASSET AssetType='CashOnHand'>
     <AssetCashorMarketValueAmount>avail_assets</AssetCashorMarketValueAmount>
    </ASSET>
    <ASSET AssetType='RealEstateOwned'>
     <AssetFaceValueAmount>re_assets</AssetFaceValueAmount>
    </ASSET>
    <VALUATIONS BuildingStatusType='const_cd'>
    </VALUATIONS>
   </INCOME>
   <PRODUCT ARMIndexType = 'arm_indx'>
    <OriginationFee>orig_fee</OriginationFee>
    <InitialNoteRatePercent>int_rate</InitialNoteRatePercent>
    <LoanAmortizationTermMonths>length_term</LoanAmortizationTermMonths>
    <ARMIndexMarginPercent>margin</ARMIndexMarginPercent>
   </PRODUCT>
   <PARTY PARTYID="orig_id" PartyType="Lender">
    <PartyName>orig_name</PartyName>
   </PARTY>
   <PARTY PARTYID="spnsr_id" PartyType="Lender">
    <PartyName>spnsr_name</PartyName>
   </PARTY>
   <PARTY PARTYID="under_id" PartyType="Underwriter">
    <PartyName>under_name</PartyName>
   </PARTY>
   <PARTY PARTYID="appraiser_id" PartyType="Appraiser">
   <LicenseType>appr_type</LicenseType>
   <PartyName>appraiser_name</PartyName>
   </PARTY>
   <PARTY PARTYID="counsel_tin" PartyType="CounselingAgency">
    <PartyName>counsel_name</PartyName>
   </PARTY>
   <BORROWER BORROWERID='n'>
    <UnparsedName>borrn_name</UnparsedName>
    <FirstName>borrn_name</FirstName>
    <MiddleName>borrn_name</MiddleName>
    <LastName>borrn_name</LastName>
    <SSN>borrn_ssn</SSN>
    <DEMOGRAPHICS>
     <BorrowerBirthDate>birth_date</BorrwerBirthDate>
     <DependentCount>children</DependentCount>
    </DEMOGRAPHICS>
   <GOVERNMENTMONITORING
  	GOVERNMENTMONITORINGID='n'
	EthnicityType = 'ethnicity'
	GenderType = 'borrn_sex'
	BorrowerFurnished = 'borrn_furn'>
      <RaceNationalOriginType RaceNationalOriginTypeID ='n'>borrn_racen</RaceNationalOriginType>
    </GOVERNMENTMONITORING>
   </BORROWER>
</MORTGAGEDATA>

End Fields for HECM Insurance Application
Name Type Description
browser String (Required Entry) Identifies the type of requester. This value is assigned to each organization using B2B by the FHA
status_flag String Determines mode and reports status, see details
msg_n Alphanumeric Output only. Up to 26 messages are possible, the first of which specifies the overall request status.
clas_data HECM Insurance returns two ProcessStatusFlag values. These values are not required for all implementations but may be helpful to those migrating from FHA Direct to B2B.
Name Values
Review Review Indicator
Clas_Data "Y" or SPACE, indicates if CLAS data is displayed. If "Y", insurance data has been entered via CLAS. Any field returned with a "W"(arning) flag may have a value different than the CHUMS database.
prop_csz Alphanumeric A string containing the City, State and Zip code for the property. (Up to 30 characters)
addr_city_name Alphanumeric Name of the city (up to 17 characters)
addr_cnty_cd Numeric FIPS county id code. (Up to 3 characters)
addr_ste_cd String State 2 character code.
addr_zip_cd Numeric ZIP Code. 9 numeric characters (+4 portion is not recorded)
addr_hse_no Alphanumeric House number (Up to 7 characters)
addr_pre_dir String Predirectional modifier, e.g. N, S, E, NW, etc.
addr_st_name Alphanumeric Name of street. (Up to 20 characters)
addr_st_tp String Street name type, e.g. St, Dr, CT, Way, etc.
addr_post_dir String Postdirectional modifier, e.g. N, S, E, NW, etc.
appl_method String (Required Entry) Specifies means by which the application was taken, FaceToFaceInterview, Mail, Telephone, Internet.
case_no Numeric (Required Entry) Number identifying/ referencing the Federal Housing Administration (FHA) case number. 10 numeric characters; first two digits identify the state where property is located, third digit identifies the Field Office where case will be processed, following six digits indicate the serial number, and the final digit is a check digit.
sale_price Integer From 1000 to 999999. Contract sales price of the property. Source: Form HUD-92900-PUR or form HUD-92900-WS, line 10a.
mip_financed String (Required Entry)Yes or No. Indicates if Mortgage Insurance Premium is financed.
mail_to_spnsr String Yes or No. Indicates if Mortgage Insurance Certificate should be mailed to sponsor.
issue_to_spnsr String Yes or No. Indicates if Mortgage Insurance Certificate should be issued in sponsor's name.
closing_dt Valid date (yyyymmdd) (Required Entry) Closing date of the loan.
adp_code Integer 3 numeric characters representing the specific code for the case type and SOA. Automated data processing code related to the section of the National Housing Act under which mortgage insurance is being requested. Sources: Form HUD-92900-A, line 4 and form HUD-92900-PUR or form HUD-92900-WS, Section of the Housing Act.
adp_chara String Fixed: Amount of the payment and the interest rate remain fixed for the life of the loan.
AdjustableRateMortgage: Interest rate changes over the life of the loan relative to changes in the index rate. Also called Adjustable Mortgage Loan (AML) or Variable Rate Mortgage (VRM).
GraduatedPaymentMortgage: Payments are low for the first few years, gradually increase for a few years, and then remain fixed.
GrowingEquityMortgage: Scheduled increases in payments, with the additional amount being used to reduce the principal.
EitherGPMorGEM
adp_charh String Type of Federal Housing Administration (FHA) Single Family Housing program, including:
FHAStandardMortgageProgram203b: Basic FHA mortgage insurance for one- to four-family housing.
Condominium234c: FHA mortgage insurance for a unit in a condominium building (which must contain at least four dwelling units).
Improvements203k: FHA mortgage insurance for a loan that covers both the acquisition and rehabilitation of a home.
ImprovementsCondominium203k: FHA mortgage insurance for a loan that covers both the acquisition and rehabilitation of a home.
HomeEquityMortgage255: FHA insurance on a reverse mortgage for a home (Home Equity Conversion Mortgage or HECM).
HomeEquityMortgageCondominium255: FHA insurance on a reverse mortgage for a home (Home Equity Conversion Mortgage or HECM).
Urban Renewal220: FHA mortgage insurance for new or rehabilitated housing located in a designated urban renewal area or area with concentrated programs of code enforcement and neighborhood development. Other: Less common FHA Single Family Housing program (e.g., 235(r) Homeownership Assistance/Refinance or 240 Fee Title Purchases).
adp_chars String Type of Federal Housing Administration (FHA) Single Family Housing special program, including:
NoSpecialProgram: A special housing program is not applicable.
IndianLands: FHA mortgage insurance for property located on Native American trust land or otherwise restricted land (property eligible for insurance pursuant to Section 248 of the National Housing Act).
HawaiianHomelands: FHA mortgage insurance for property located within Hawaiian homelands (property eligible for insurance pursuant to Section 247 of the National Housing Act).
MilitaryImpactArea: FHA mortgage insurance for property located in a military impacted area designated by the Secretary of Defense (property eligible for insurance pursuant to Section 238(c) of the National Housing Act).
223eLocationWaiver: FHA mortgage insurance for property in an older, declining urban area where there is a need for affordable housing (property eligible for insurance pursuant to Section 223(e) of the National Housing Act).
adp_charb String Yes, No
Indicator specifying whether there is an interest buydown sales incentive to reduce the amount of the borrower's payments during the early years of the loan.
arm_eri String Rate used to calculate the expected average mortgage interest rate on an adjustable rate mortgage (ARM).
  • 10YEARCMT: Constant Maturity Treasury (CMT) rate for an ARM tied to the 1 Month CMT or 1 Year CMT index.
  • 10YEARLIBORSWAP: London Interbank Offered Rate (LIBOR) swap rate for an ARM tied to the 1 Month LIBOR or 1 Year LIBOR index.
program_id Integer Mortgage program under which an insurance application is made.
orig_id Numeric Originator id, 10 numeric characters
spnsr_id Numeric Sponsor id, 10 numeric characters
appraiser_id Alphanumeric Appraiser State license id, up to 22 alpha-numeric characters
escrow String (Required Entry If Not In System) One selection:
- Yes
- No Indicates if money has been withheld to perform repairs.
complete_dt Date (Required Entry If FHAVARepairEscrow is Yes) Date repairs are to be completed within one year of Closing Date. Valid date (yyyymmdd)
amount Integer (Required Entry If FHAVARepairEscrow is Yes) 1-99999 Amount held in escrow to complete repairs.
closing_costs Integer (Required Entry) Up to 6 numeric characters. Estimated closing costs.
req_invst Integer Up to 6 digits. Cash investment needed to close the sale of the property. Source: Form HUD-92900-PUR, line 10d or form HUD-92900-WS, line 10h.
under_dt Date (Required Entry) Date underwriter approved case.
under_id Alphanumeric (Required Entry) 4 characters. ID of underwriter who approved mortgage insurance application.
counsel_tin Integer (Required Entry) 9 characters. TIN of HECM Counseling agency
hecm_cert Alphanumeric 9 characters. Certificate number issued HECM Counseling agency when counseling has been completed.
counsel_date Date (Required Entry) Date HECM counseling performed
counsel_name String (Output) Name of HECM counseling agency
exist_liens Integer (Optional Entry) 1-999999 All existing liens against the property.
debts_non_re Integer (Optional Entry) 1-999999 All debts not related to real estate.
re_debts Integer (Optional Entry) 1-999999 If entered, must be equal to or greater than existing liens. Total amount of real estate debt.
exp_rate Numeric (Required Entry) .001-30.00 Rate at which interest is charged on mortgage. Can be Fixed or Adjustable.
arm_type String (Required Entry If ADP Code Is For An ARM) One selection:
- NotApplicable
- Annual
- Monthly. Adjustment frequency of an ARM.
cap Numeric (Required Entry If ADP Code Is For An ARM And ARM Type Is Monthly) 0.001-40.0 Maximum interest rate during the life of the loan.
payment String (Required Entry for update)
Describes payment plan, must be one of 5 discrete strings:
LineOfCredit
Tenure
Term
ModifiedTenure
ModifiedTerm
principal_limit Numeric (Required Entry) 6 characters. Preset value of payments available to the borrower. Value must not exceed the Maximum Claim Amount which is based on the property value and the Mortgage Credit Limit.
max_claim_amt Numeric 6 characters. Maximum amount HUD will pay on a claim for FHA insurance benefits. This amount is based on the property value or FHA mortgage limit for the area, whichever is less. Upfront mortgage insurance premium is based on this system-generated amount.
lender_end String SUBMISSION VALUES:
Endorse   Endorsement Requested
DoNotEndorse  Endorsement is not Requested

RETURN VALUES
Endorsed   The loan is insured
NotEndorsed  The loan is not insured
NotLIEndorsable  Indicates that a risk factor associated with this case requires preendorsement review in the HOC

pud_ind String (Required Entry). Yes - No Indicates property is a Planned Unit Development.
fac_fab String (Required Entry) Yes - No Indicates if home is manufactured.
prop_value Integer (Required Entry) 1-999999 Appraiser's estimate of the market value of the property to the nearest dollar; does not include the closing costs.
living_units Integer 1-11 Number of individual livable units at address.
avail_assets Integer (Optional Entry) 1-999999 Total assets available for closing, including cash, savings bonds, and securities.
re_assets Integer (Required Entry) 1-999999 Must be equal to or greater than property value. Total value of real estate assets.
const_cd String (Required Entry) Proposed, UnderConstruction, Existing
arm_indx String The index used by the lender to determine changes in the interest rate for an adjustable rate mortgage (ARM).
  • CMT1MONTH: Constant Maturity Treasury (CMT) index, which is the average yield on United States Treasury securities adjusted to a constant maturity of 1 month, as made available by the Federal Reserve Board.
  • CMT1YEAR: Constant Maturity Treasury (CMT) index, which is the average yield on United States Treasury securities adjusted to a constant maturity of 1 year, as made available by the Federal Reserve Board.
  • LIBOR1MONTH: London Interbank Offered Rate (LIBOR) index, which is the rate of interest at which banks offer to lend money to one another in the London wholesale money markets. The index value is adjusted on a monthly basis.
  • LIBOR1YEAR: London Interbank Offered Rate (LIBOR) index, which is the rate of interest at which banks offer to lend money to one another in the London wholesale money markets. The index value is adjusted on an annual basis.
orig_fee Integer (Required Entry) 5 digits Origination fees on loan.
monthly_income Integer (Optional Entry) 1-999999 Total gross monthly income of borrower.
Parties Alphanumeric (Output field) Provides the id of referenced party for reference to retrieve details (such as names.) The PARTYID is a lender id, an Underwriter id, HECM Counseling Agency TIN or an Appraiser id. PartyType may be Lender, Appraiser or Underwriter
appr_type String The type of appraiser. Valid values are Licensed, CertifiedGeneral, CertifiedResidential
orig_name Alphanumeric (Output field) Name of originator
spnsr_name Alphanumeric (Output field) Name of sponsor
under_name Alphanumeric (Output field) Name of underwriter
appraiser_name Alphanumeric (Output field) Name of appraiser
Borrower Records (Up to 5 records) Note: DependantCount is only read and produced for borrowerid = '1'
borrx_name Alphanumeric (Required Entry If Not In System) Name of borrower. Last, First MI (up to 22 alphabetic characters)
borrx_name Alphanumeric (Required Entry If Not In System) First Name Borrower names may be entered in FirstName, MiddleName and Last Name portions instead of via UnparsedName but the total length (including system generated formatting to Last, First Middle) must not exceed 22 characters or the name will be truncated.
borrx_name Alphanumeric (Required Entry If Not In System) Middle Name Borrower names may be entered in FirstName, MiddleName and Last Name portions instead of via UnparsedName but the total length (including system generated formatting to Last, First Middle) must not exceed 22 characters or the name will be truncated.
borrx_name Alphanumeric (Required Entry If Not In System) Last Name Borrower names may be entered in FirstName, MiddleName and Last Name portions instead of via UnparsedName but the total length (including system generated formatting to Last, First Middle) must not exceed 22 characters or the name will be truncated.
borrx_ssn Numeric (Required Entry) 9 numeric characters Borrower's Social Security Number (SSN).
borrx_birth Date (Required Entry) Birth date of the borrower.
children Integer (Optional Entry) 0-30 Total number of the borrower's children. Only entered for primary borrower.
GOVERNMENTMONITORINGID Each GOVERNMENTMONITORING element is linked to a specific borrower element via matching integers in the ID attribute. (GOVERNMENTMONITORINGID = BORROWERID)
borrx_sex String (Required Entry) Borrower's gender. One selection:
- Female
- Male
- NotApplicable
ethnicity String (Required Entry) Ethnicity of borrower. One selection:
- Hispanic
- NonHispanic (Omit attribute or send a space character when not applicable for borrower type.)
borrn_furn String Yes, No. Indicates if sex, race age and ethnicity were furnished by the borrower.
borrx_race String (Required Entry) Up to 5 race descriptions may be entered.
- White
- Black
- AmericanIndianOrAlaskanNative
- NativeHawaiianPacificIslander
- Asian
int_rate Numeric (Required Entry) Rate at which interest is charged on mortgage. Format: .001-19.999
term_length Integer (Required Entry If Term Field Is Entered; Cannot Exceed Term In Months As Defined By The ADP Code) Number of months between the first and last payments to the borrower. 3 characters
margin Numeric (Required Entry If ARM Is Annual Or Monthly) Difference between the index used by a lender and the interest rate. Format: 0.001-9.999


End of ProcessStatusCode Values

Input values
Query Retrieve case data.
Update Modify case data.

Output values
SuccessUpdatesAllowed This indicates that the HECM Insurance Application request was processed. This result occurs when an Add or Update process is requested and is successful.
SevereWarning Individual data items are valid but the combination of data or lack of data (no upfront MIP paid) produces a situation that will prohibit endorsement of the case. Data is accepted and stored on the CHUMS database. When conditions are corrected, the case is endorsable. Please see the <ProcessStatusMessage> for details.
Warning This indicates that the case was endorsable and the HECM Insurance Application request was processed, however there might be some discrepancies in the input data and the user needs to verify. Please see the <ProcessStatusMessage> for details. A Warning is also issued when a query is posted against an endorsed case.
Unavailable System is down
Error This indicates that an error has occurred during the HECM Insurance Application process. The error might be caused by an unauthorized access, missing data or invalid data, etc.. Please see the <ProcessStatusMessage> for details.
When an error occurs, the request to update, add or query a record is not processed.


Comments or Questions? <SF Administration>

 

 
Content current as of 18 March 2009   Follow this link to go  Back to top   
----------
FOIA Privacy Web Policies and Important Links  Home [logo: Fair Housing and Equal Opportunity]
[Logo: HUD seal] U.S. Department of Housing and Urban Development
451 7th Street S.W., Washington, DC 20410
Telephone: (202) 708-1112   TTY: (202) 708-1455
Find the address of a HUD office near you