Worked Example — Conventional Refinance (Affordability / AMI-Qualified)

monthly_income at or below 80% AMI triggers HomeReady® Refi and Home Possible® Refi — even with first_time_homebuyer: false. Rate/term refi, no cash out, Beverly Hills CA.

AMI-Based Eligibility:
80% AMI for Beverly Hills (90210) is ~$6,167/month. At $5,000/month this borrower qualifies automatically. At 33% LTV ($500K/$1.5M) there is no PMI on any product.

Scenario Parameters

Parameter	Value
Loan Purpose	Refinance (Rate/Term)
Loan Type	Conventional
First Time Homebuyer	false
List Price	$1,500,000
Loan Amount	$500,000
LTV	33.3%
Cash Out	$0
Credit Score	780
State / City / ZIP	CA / Beverly Hills / 90210
Monthly Income	$5,000 (below 80% AMI)
Loan Term	30 years
loid	44

Request Payload

first_time_homebuyer: false — AMI eligibility is triggered purely by monthly_income. cash_out: 0 = rate/term refi.

POST https://api.bankingbridge.com/rateflow
Content-Type: application/json
x-api-key: uL6aLuwfcq1dUvEZTq3Gv2O0KgorNbYXXXXXXXX

{
  "lock_period": 30,
  "first_time_homebuyer": false,
  "loan_type": "Conventional",
  "list_price": 1500000,
  "loan_purpose": "refinance",
  "loan_amount": 500000,
  "credit_score": 780,
  "state": "CA",
  "city": "Beverly Hills",
  "zipcode": "90210",
  "coords": { "lat": 0, "lng": 0 },
  "residency_type": "primary_home",
  "property_type": "single_family_home",
  "cash_out": 0,
  "waive_escrows": false,
  "monthly_income": 5000,
  "loan_term": "30",
  "loid": 6309,
  "id": 44,
  "withCredentials": false,
  "min_credit": 780,
  "aus": "NotSpecified"
}

cURL Example

curl -X POST "https://api.bankingbridge.com/rateflow" \
  -H "x-api-key: uL6aLuwfcq1dUvEZTq3Gv2O0KgorNbYXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "lock_period": 30,
    "first_time_homebuyer": false,
    "loan_type": "Conventional",
    "list_price": 1500000,
    "loan_purpose": "refinance",
    "loan_amount": 500000,
    "credit_score": 780,
    "state": "CA",
    "city": "Beverly Hills",
    "zipcode": "90210",
    "residency_type": "primary_home",
    "property_type": "single_family_home",
    "cash_out": 0,
    "monthly_income": 5000,
    "loan_term": "30",
    "loid": 6309,
    "id": 44,
    "min_credit": 780,
    "aus": "NotSpecified"
  }'

JavaScript (fetch) Example

const response = await fetch("https://api.bankingbridge.com/rateflow", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": "uL6aLuwfcq1dUvEZTq3Gv2O0KgorNbYXXXXXXXX"
  },
  body: JSON.stringify({
    lock_period: 30,
    first_time_homebuyer: false,
    loan_type: "Conventional",
    list_price: 1500000,
    loan_purpose: "refinance",
    loan_amount: 500000,
    credit_score: 780,
    state: "CA",
    city: "Beverly Hills",
    zipcode: "90210",
    residency_type: "primary_home",
    property_type: "single_family_home",
    cash_out: 0,
    monthly_income: 5000,
    loan_term: "30",
    loid: 6309,
    id: 44,
    min_credit: 780,
    aus: "NotSpecified"
  })
});
const data = await response.json();
console.log(data.pricing_results);

Python (requests) Example

import requests

headers = {
  "Content-Type": "application/json",
  "x-api-key": "uL6aLuwfcq1dUvEZTq3Gv2O0KgorNbYXXXXXXXX"
}

payload = {
  "lock_period": 30,
  "first_time_homebuyer": False,
  "loan_type": "Conventional",
  "list_price": 1500000,
  "loan_purpose": "refinance",
  "loan_amount": 500000,
  "credit_score": 780,
  "state": "CA",
  "city": "Beverly Hills",
  "zipcode": "90210",
  "residency_type": "primary_home",
  "property_type": "single_family_home",
  "cash_out": 0,
  "monthly_income": 5000,
  "loan_term": "30",
  "loid": 6309,
  "id": 44,
  "min_credit": 780,
  "aus": "NotSpecified"
}

response = requests.post(
  "https://api.bankingbridge.com/rateflow",
  json=payload,
  headers=headers
)
data = response.json()

Sample Response Structure

At 33% LTV, pmi_monthly is 0 for all products.

{
  "returncode": 0,
  "status": "success",
  "pricing_results": [
    {
      "program_name": "HomeReady Refi",
      "rate": 6.250,
      "pmi_monthly": 0
    },
    {
      "program_name": "Home Possible Refi",
      "rate": 6.250,
      "pmi_monthly": 0
    },
    {
      "program_name": "Standard Conventional",
      "rate": 6.500,
      "pmi_monthly": 0
    }
  ]
}

AMI Refinance Key Takeaways:

• No FTHB flag needed: Any primary refi borrower below 80% AMI receives affordability products automatically.
• No PMI at 33% LTV: pmi_monthly is 0 across all results.
• High-value property, AMI-qualified: Eligibility is income vs. local AMI only — not property value.