Mortgage Fees
Calculating Fees
Mortgage fees are calculated internally based on the selected value in loanType and returned in the pricing call response. Loan-specific API endpoints are called to determine fees when pricing FHA, VA, or USDA loans. Therefore, it is not necessary for users to call fee pricing calls explicitly.
Advanced users who wish to make API calls to return separate fee data can reference the following table for more information. Use these calls to price only the loan fee or the miPremium:
| Fee | API Endpoint |
|---|---|
| FHA | https://{{domain}}/rest/v1/public-fee-api/getFhaFeeForLoan |
| VA | https://{{domain}}/rest/v1/public-fee-api/getVaFeeForLoan |
| USDA | https://{{domain}}/rest/v1/public-fee-api/getUsdaFeeForLoan |
| Annual Premium Fee | https://{{domain}}/rest/v1/public-fee-api/getAnnualPremiumForLoan |
Important Request Fields
BorrowerCriteria.loanType: Mortgage fees are calculated based on the type of loan the user is searching for. This is set inloanTypeand is required.BorrowerCriteria.ufmipFinanced: If the loan is financed, the fee is added to the total loan amount andufmipFinanced = "Yes". There are no additional closing costs if the fee is financed.BorrowerCriteria.feeType:feeTypeselects for the type of fee from a set of enum values. It is not required.
For any fee, a pre-computed DTI (debt-to-income) value can be passed using the criteria.clientDti field:
"criteria": {
clientDti": 0.32
},
Responses
In the UI, the fee appears as the fields Guarantee Fee and Funding Fee (for FHA or VA fees).
In the API, a typical pricing search returns all fees, as well as the annual premium fee, with the pricing response in the line results. The annual premium is not considered a fee, but applies specifically to FHA loans.
The result also indicates whether or not the loan is financed. The base search portion of the result contains the ufmipFinanced, which returns a "YES" (is financed) or "NO" (is not financed) result.
If not financed, the fee will appear in the closing cost of the line result:
-
loanFeeAmountreturns the fee amount. -
loanFeePercentreturns the fee percentage. -
annualMiPremiumAmountreturns the annual premium fee amount. This applies only to FHA loans but is NOT the FHA fee. -
The fee will also appear under
description.Example:
"description": "Funding Fee".
See the following sections for more information on making fee requests and retrieving fee data from the response for individual fees:
Example Result
Click to expand example pricing response
{
"dataEventId": "606b73ff8a1e0e000187547b-66230",
"baseSearch": {
"id": "606b73ff8a1e0e0001875471",
"allowModifiedDate": true,
"titleVendorQuestions": [],
"useExternalFees": true,
"showTitleQuestion": true,
"debugLevel": "WARNING",
"pricingOrigin": "ApiPricing",
"companyId": "55afea6ee4b04b10ed2d6a12",
"criteria": {
"id": "606b73ff8a1e0e0001875476",
"purchasePrice": 500000,
"loanAmount": 400000,
"rehabBudget": 0,
"totalLoanAmount": 0,
"computeApr": true,
"totalLoanAmountByMortgageType": {
"Conventional": 400000
},
"subordinateLoanAmount": 0,
"pmiType": "None",
"monthlyIncome": 5000,
"monthlyDebt": 2150,
"lineAmount": 0,
"drawAmount": 0,
"appraisedValue": 0,
"isFirstLienSame": "",
"employeeLoan": "",
"loanYear": 30,
"loanPurpose": "Purchase",
"loanType": "Fixed",
"paymentInterestType": "FullPITI",
"mortgageTypes": [
"Conventional"
],
"mortgageLimitMapByYear": {
"2021": {
"mortgageLimit": "Conforming",
"fhaMortgageLimit": 822375
}
},
"highBalanceCountyMappedByYear": {
"2021": true
},
"mortgageLimitForLatestYear": {
"mortgageLimit": "Conforming",
"fhaMortgageLimit": 822375,
"year": 2021,
"conventionnalLoanLimitAmount": 548250,
"matchingCountyLoanLimit": 822375,
"countyLoanLimit1Unit": 822375,
"countyLoanLimit2Unit": 1053000,
"countyLoanLimit3Unit": 1272750,
"countyLoanLimit4Unit": 1581750
},
"mortgageLimit": "Conforming",
"fhaMortgageLimit": 822375,
"propertyUse": "PrimaryResidence",
"ownProperties": 0,
"veteranType": "Active_Or_Veteran",
"vaUsageType": "First_Use",
"ufmipFinanced": "YES",
"fundingFeeFinanced": "YES",
"propertyValuationType": "Full_Appraisal",
"calculatedfeeAmount": 0,
"calculatedFeeByMortgageType": {},
"affinityCode": "",
"affinityCodes": [],
"specialMortgageOptions": [],
"inclusive": false,
"varaiableLoanTypes": [],
"fico": 760,
"cemaIndicator": false,
"downPaymentAmount": 0,
"lienPriorityType": "FirstLien",
"compensationType": "LenderCompPlan",
"totalLoanAmountByVaType": {},
"subordinate": false,
"loanDownPayement": 0,
"valueOfCollateral": 500000,
"highBalanceCounty": true,
"ltv": 0.8,
"lenderFeeWaiver": true,
"escrowWaiver": false,
"cltv": 0.8,
"dti": 0.43,
"loanDownPayment": 0,
"hcltvDrawAmount": 0,
"hcltvLineAmount": 0
},
"property": {
"id": "606b73ff8a1e0e0001875477",
"allowModifiedDate": true,
"creationDate": "2021-04-05T20:33:03Z",
"modifiedDate": "2021-04-05T20:33:03Z",
"address": {
"longitude": null,
"latitude": null,
"censustract": "06037",
"street": "",
"streetCont": "",
"city": "Pasadena",
"zip": "91101",
"zipExt": "",
"state": "CA",
"province": "",
"county": "06037",
"countyName": "LOS ANGELES",
"country": "US",
"countyFips": "06037",
"stateFips": ""
},
"propertyType": "SingleFamily",
"numberOfUnit": 1,
"bedrooms": 0,
"bathrooms": 0,
"finishedSqFt": 0,
"lotSizeSqFt": 0,
"lotSizeAcre": 0,
"yearBuilt": 0,
"mls": "",
"totalRooms": 0,
"propertyDescription": "",
"price": 0,
"priceDate": "",
"hoa": 0,
"taxAssessment": 0,
"taxAssessmentYear": "",
"propertyTaxPercent": 0,
"propertyTaxYear": "",
"lastSoldPrice": 0,
"lastSoldDate": "",
"jsonImages": [],
"links": [],
"forSale": false,
"features": [],
"constructions": [],
"facts": []
},
"brokerCriteria": {
"id": "606b73ff8a1e0e0001875478",
"allowModifiedDate": true,
"creationDate": "2021-04-05T20:33:03Z",
"modifiedDate": "2021-04-05T20:33:03Z",
"searchContext": {},
"overrideExistingComplan": false,
"rateTypes": [],
"view": "LenderPaid",
"businessSourceType": "BST_NA",
"feeServicerList": [],
"rangeComplan": {
"@class": "com.cre8techlabs.entity.range.DoubleRangeGeLe",
"from": null,
"to": null
},
"sortStrategy": "APR",
"priceBucketList": [],
"resultPerBucket": 1,
"dayLocks": 30,
"dayLocksList": [
15,
30,
45,
60,
75,
90
],
"ausList": [
"None",
"LP",
"DU"
],
"ausIndicator": "",
"closingCostRange": {
"@class": "com.cre8techlabs.entity.broker.BrokerCriteria$RangeClosingCost",
"from": null,
"to": null,
"closestToPar": false,
"infinite": true
},
"displayConventionalRate": false
},
"accessCriteria": {
"id": "606b73ff8a1e0e0001875479",
"marketPlaceSearch": false,
"includeMonthlyPaymentDetail": false,
"dataLog": true,
"companyIds": [],
"companyMap": {},
"ratePeriodMap": {},
"overrideNode": 25,
"fieldsToRemove": []
},
"miCriteria": {
"miCompanyId": null,
"miCompanyName": null,
"amortizationType": "FullyAmmortized",
"loanType": "Fixed",
"duLpDecision": "DU_Approve_Eligible",
"buyDownPercent": "None",
"originationChannel": "Retail",
"loanProgram": null,
"renewalType": "Constant",
"paymentPlan": "EZMonthly",
"paymentType": "Monthly",
"coBorrowerFicoScore": null,
"varaiableLoanType": null,
"monthlyPlanRefundable": false,
"singlePlanRefundable": false,
"borrowerNonTraditionalCredit": false,
"coBorrowerNonTraditionalCredit": false,
"borrowerSelfEmployed": false,
"coBorrowerSelfEmployed": false,
"buydownUpfrontAmount": null,
"needCoBorrower": false,
"initialPremiumAtClosing": "Deferred",
"rateQuoteAllProductIndicator": false,
"rateQuoteProductComparisonIndicator": false,
"miPremiumFinancedIndicator": false,
"premiumRatePlanType": "Level",
"miRateSource": null,
"numberOfDeferredPayments": 0
},
"dynamicPropertiesMap": {},
"rateGridIds": [],
"rateProgramIds": [],
"ratePeriodIds": [
"5f458ed9ce8ad000019132cc"
],
"investors": [],
"investorIds": [],
"test": false,
"skipAdjustments": false,
"filter": {
"programNames": [],
"productCode": []
},
"globalGroupAdjustmentMap": {},
"showDisqualify": false,
"showDisqualifyRules": true,
"sortAscPoints": true,
"showUnmatchCompPlan": false,
"feeCriteria": {},
"closingCost": {
"closingCostGroup": [],
"settlementCost": {
"origination": {
"othersLabel": "Fee",
"others": 0,
"underwritingLabel": "Underwriting",
"underwriting": 0,
"administrationLabel": "Administration Fee",
"administration": null,
"lenderCreditLabel": "Lender Credit",
"lenderCredit": null,
"total": 0
},
"titleService": {
"overrideTitle": false,
"titleInsuranceLabel": "Title Insurance Cost",
"titleInsurance": null,
"borrowerTitlePaidPercentLabel": "Borrower Title Insurance Percent",
"borrowerTitlePaidPercent": 0.5,
"overrideEscrow": false,
"escrowCostLabel": "Escrow Cost",
"escrowCost": null,
"borrowerEscrowPaidPercentLabel": "Borrower Escrow Cost Percent",
"borrowerEscrowPaidPercent": 0.5,
"notarySignLabel": "Notary Sign",
"notarySign": 145,
"total": 145
},
"thirdPartyServices": {
"appraisalLabel": "Appraisal",
"appraisal": 500,
"taxServiceLabel": "Tax Service",
"taxService": 0,
"creditReportLabel": "Credit Report",
"creditReport": 0,
"floodCertificationLabel": "Floor Certification",
"floodCertification": 12,
"overnightLabel": "Overnight",
"overnight": 16,
"recordingLabel": "Recording",
"recording": 85,
"total": 613
},
"closingCostGroup": [],
"total": 758
},
"useClosingCost": false,
"useCompanyDefaultClosingCost": false,
"useErnstCost": false,
"allowErnstQuote": false,
"total": 758
},
"multiSearchClosingCostList": [],
"showInterpolatedPricing": false,
"targetInterpolatedPrice": 0,
"showAllDayLocksForInterpolatedRates": false,
"rates": [],
"rateRange": {
"@class": "com.cre8techlabs.entity.range.DoubleRangeLeGt",
"from": null,
"to": null,
"null": true
},
"maxListingPerRate": -1,
"computedExpirationDate": "2021-05-06T06:59:59Z",
"showPayeeDetail": false,
"loanAmountCriteria": [
400000
],
"termsCriteria": [
30
],
"loanPurposeCriteria": [
"Purchase"
],
"loanTypeCriteria": [
"Fixed"
],
"varLoanTypeCriteria": [],
"titleVendors": [],
"requestId": "606b73ff8a1e0e000187547a",
"loanPurpose": {
"values": [
"Purchase"
],
"type": "com.cre8techlabs.entity.rate.LoanPurpose"
},
"loanType": {
"values": [
"Fixed"
],
"type": "com.cre8techlabs.entity.rate.LoanType"
},
"amortizationType": {
"values": [
"_1_1",
"_2_1",
"_3_1",
"_3_6",
"_5_1",
"_5_2",
"_5_5",
"_5_6",
"_7_1",
"_7_2",
"_7_6",
"_10_1",
"_10_6"
],
"type": "com.cre8techlabs.entity.rate.VaraiableLoanType"
},
"mortgageTypes": {
"values": [
"Conventional"
],
"type": "com.cre8techlabs.entity.rate.MortgageType"
},
"multi": true
},
"resultMap": [
{
"resultRates": {
"allowModifiedDate": true,
"dayLock": 30,
"dayLocksList": [],
"rateSet": [
2.25,
2.375,
2.5,
2.625,
2.75,
2.875,
2.99,
3,
3.125,
3.25,
3.375,
3.5,
3.625,
3.75,
3.875,
4,
4.125,
4.25,
4.375,
4.5
],
"monthlyPaymentMapByRate": {
"2.25": 1528.98,
"2.375": 1554.61,
"2.5": 1580.48,
"2.625": 1606.6,
"2.75": 1632.96,
"2.875": 1659.57,
"2.99": 1684.26,
"3.0": 1686.42,
"3.125": 1713.5,
"3.25": 1740.83,
"3.375": 1768.38,
"3.5": 1796.18,
"3.625": 1824.21,
"3.75": 1852.46,
"3.875": 1880.95,
"4.0": 1909.66,
"4.125": 1938.6,
"4.25": 1967.76,
"4.375": 1997.14,
"4.5": 2026.74
},
"data": {
"2.25": [
{
"dti": 0.735796,
"hti": 0.305796,
"mortgageType": "Conventional",
"loanPurpose": "Purchase",
"loanAmount": 400000,
"term": 30,
"dayLock": 30,
"baseRates": 2.25,
"adjustedRates": 2.25,
"adjustmentRates": 0,
"apr": 2.4655,
"closingCost": {},
"closingCostDetails": [],
"finalClosingCost": 11272,
"closingCostDetailsBorrowerPaid": [],
"finalClosingCostBorrowerPaid": 11272,
"compliancesMapByType": {},
"pmiType": "None",
"ratePeriod": {
"id": "5f458ed9ce8ad000019132cc",
"rateType": "All",
"classType": "RatePeriod",
"fees": [],
"parentRateOrCompanyInvalid": false,
"showCompanyName": false,
"company": {
"id": "55afea6ee4b04b10ed2d6a12",
"allowModifiedDate": true,
"name": "Flagstar Bank, FSB",
"shortName": "Flagstar Bank",
"guideLines": true,
"turnTimes": [],
"nmlsId": "417490",
"allowPublicReview": false,
"website": "www.flagstar.com",
"customRateFiles": {}
},
"name": "Flagstar Correspondent Rates",
"validAsOf": "2021-04-05T16:31:22Z",
"fileKeyForAutoImport": "Flagstar Del Corr_xlsx",
"autoImportClz": "com.cre8techlabs.service.rate.auto.company.universal.UniversalExcelXlsFiller",
"overrideHoldBack": 0,
"publish": true,
"public": false,
"expired": false
},
"rateProgram": {
"id": "5d794eb34cedfd000143ff70",
"name": "Conforming Agency Fixed"
},
"rateGrid": {
"id": "5d794eb34cedfd000143ff73",
"closingDays": [
15,
30,
45,
60,
75,
90
],
"maxCompensation": -4,
"note": "",
"compPlan": null,
"adjustmentCap": null,
"ltvModifierCapRange": null,
"ficoModifierCapRange": null,
"disregardFhaLoanLimit": false,
"pmiTypes": [],
"mortgageTypes": [
"Conventional"
],
"mortgageLimits": [
"Conforming"
],
"specialtyProduct": null,
"loanType": "Fixed",
"armMargin": null,
"armCaps": null,
"specialMortgageOptions": [],
"varaiableLoanTypes": [],
"aus": [
"LP"
],
"libor": null,
"liborType": null,
"liborMigratedtoLiborType": false,
"productCode": "Conforming",
"loanPlanId": null,
"lockGroup": null,
"maxCompensationDollarAmount": null,
"vaLoanType": null,
"agency": null,
"loanPurposes": [
"Purchase",
"Refinance",
"CashoutRefinance"
],
"terms": [
30
],
"mortgageLimitsMatchedWithSearch": [
"Conforming"
],
"mortgageLimitYearMatched": 2021,
"fhaMortgageLimitToMatch": null,
"name": "Freddie Mac 30-Year Fixed",
"displayName": "Freddie Mac 30-Year Fixed"
},
"conditionActions": [],
"programName": "Freddie Mac 30-Year Fixed",
"expired": false,
"productName": "30-Year Fixed",
"appraisalWaiverIndicator": false,
"highBalanceIndicator": false,
"borrowerPaidPoints": 2.818,
"borrowerPaidAmount": 11272,
"sameServiceIndicator": false,
"apor": 0,
"indexRate": 0,
"loanFeePercent": {},
"loanFeeAmount": {},
"amortizationSchedule": {},
"annualMiPremiumAmount": 0,
"monthlyPaymentAmount": 0,
"monthlyTotal": 1528.98,
"interestOnlyAmount": 750,
"interestPlusFixedPrinciple": -28.980000000000018,
"totalLoanAmount": 400000,
"undiscountedInterestRatePercent": 0,
"bonafideAmount": 0,
"adjustedPricingExceptionAmount": 0,
"adjustedLockExtentionAmount": 0,
"cashToCloseAmount": 0,
"cashToCloseItems": [],
"qualifyingRatePercent": 2.25,
"athenaFees": [],
"discountStartedAdjustedRate": 0,
"companyName": "Flagstar Bank",
"totalGroupAdjustmentPropertiesByAdjType": {},
"totalGroupAdjustmentPropertiesBorrowerPaidByAdjType": {},
"totalGroupRateAdjustmentPropertiesByAdjType": {},
"discountDetail": {
"discountRate": null,
"discountAmount": null
},
"premiumDetail": {
"premiumRate": null,
"premiumAmount": null
},
"lenderFeeWaiver": false,
"totalGroupAdjustmentPropertiesBorrowerPaid": 0.0020000000000000018,
"totalGroupAdjustmentProperties": 0.0020000000000000018,
"totalGroupRateAdjustmentProperties": 0,
"mortgageLimitsMatchedWithSearch": [
"Conforming"
]
},