curatedapi
Browse the docs

Guides

Finance

Excel functions

Late payments

E-invoices

Accounting

Number checks

VAT and GST

Billing and pricing

Money and currencies

Dates and time

Math

Unit conversion

Everyday

Health

USDA loan guarantee fee API

The upfront guarantee fee and the annual fee on a USDA guaranteed home loan, at the rates USDA Rural Development set for fiscal year 2027.

POST https://api.curatedapi.com/v1/calc/finance/usda-guarantee-fee

A USDA Single Family Housing Guaranteed loan has an upfront guarantee fee of 1.00% and an annual fee of 0.35%, for purchases and refinances in fiscal year 2027 (1 October 2026 to 30 September 2027). The upfront fee can be added to the loan; it is then 1% of the loan including the fee. The annual fee is paid monthly.

Formula

financed: loan with fee = loan ÷ 0.99, fee = the difference; paid in cash: fee = 1% × loan; monthly at start = loan × 0.35% ÷ 12
  • Rates were compared with USDA's notice on 12 November 2026. USDA sets them for each fiscal year.
  • Amounts are plain numbers in any single currency; no currency conversion is done.

Inputs

Send numbers as strings to keep every digit. options sets precision and rounding (see numbers and rounding).

InputTypeDescription
loan_amount required decimal (string) The loan before the upfront fee is added. Allowed: > 0 and <= 1000000000000000. Unit: currency.
finance_upfront_fee boolean
default True
Whether the upfront fee is added to the loan instead of paid in cash.
options.rounding half_even | half_up | half_down | up | down | ceiling | floor Rounding mode applied once to each result. Default half_even.
options.decimals integer Round results to this many digits after the decimal point.

Result

Under result in the answer, next to exactness, precision, inputs, formula, references and warnings.

ResultTypeDescription
upfront_feedecimal (string)The upfront guarantee fee. Unit: currency.
loan_amount_with_feedecimal (string)The loan after the fee is added, or the loan as given when it is paid in cash. Unit: currency.
annual_fee_percentstringThe annual fee rate. Unit: percent.
monthly_annual_fee_at_startdecimal (string)One twelfth of the annual fee on the starting loan. The fee is worked out again each year on the scheduled balance, so it falls as the loan is repaid. Unit: currency.

Examples

A loan of 200,000 with the fee financed

Requestcurl
curl https://api.curatedapi.com/v1/calc/finance/usda-guarantee-fee \
  -H "Authorization: Bearer $CURATEDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "loan_amount": "200000",
    "finance_upfront_fee": true
  }'
200 OKResponse
{
  "calculator": "finance/usda-guarantee-fee@1",
  "result": {
    "upfront_fee": "2020.20",
    "loan_amount_with_fee": "202020.20",
    "annual_fee_percent": "0.35",
    "monthly_annual_fee_at_start": "58.92"
  },
  "exactness": {
    "upfront_fee": "exact",
    "loan_amount_with_fee": "exact",
    "monthly_annual_fee_at_start": "rounded"
  },
  "precision": {
    "rounding": "half_even",
    "decimals": 2
  },
  "inputs": {
    "loan_amount": "200000",
    "finance_upfront_fee": true
  },
  "formula": "financed: loan with fee = loan ÷ 0.99, fee = the difference; paid in cash: fee = 1% × loan; monthly at start = loan × 0.35% ÷ 12",
  "references": [
    {
      "title": "USDA Rural Development: Single Family Housing Guaranteed Loan Program fees for fiscal year 2027 (upfront 1.00%, annual 0.35%)",
      "url": "https://content.govdelivery.com/accounts/USDARD/bulletins/42b1054"
    }
  ],
  "warnings": []
}

The same loan with the fee paid in cash

Requestcurl
curl https://api.curatedapi.com/v1/calc/finance/usda-guarantee-fee \
  -H "Authorization: Bearer $CURATEDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "loan_amount": "200000",
    "finance_upfront_fee": false
  }'
200 OKResponse
{
  "calculator": "finance/usda-guarantee-fee@1",
  "result": {
    "upfront_fee": "2000.00",
    "loan_amount_with_fee": "200000.00",
    "annual_fee_percent": "0.35",
    "monthly_annual_fee_at_start": "58.33"
  },
  "exactness": {
    "upfront_fee": "exact",
    "loan_amount_with_fee": "exact",
    "monthly_annual_fee_at_start": "rounded"
  },
  "precision": {
    "rounding": "half_even",
    "decimals": 2
  },
  "inputs": {
    "loan_amount": "200000",
    "finance_upfront_fee": false
  },
  "formula": "financed: loan with fee = loan ÷ 0.99, fee = the difference; paid in cash: fee = 1% × loan; monthly at start = loan × 0.35% ÷ 12",
  "references": [
    {
      "title": "USDA Rural Development: Single Family Housing Guaranteed Loan Program fees for fiscal year 2027 (upfront 1.00%, annual 0.35%)",
      "url": "https://content.govdelivery.com/accounts/USDARD/bulletins/42b1054"
    }
  ],
  "warnings": []
}

References

Results follow each calculator's documented rules and the sources listed. They are not financial, tax or legal advice. Check that the rules fit your case before you rely on a result. See the terms.

Errors share one format; see errors. Billing, retries and batches work the same for every endpoint.