Worked Example — VA IRRRL Refinance

VA IRRRL (Interest Rate Reduction Refinance Loan) — VA Streamline Refinance. No appraisal required in most cases, reduced 0.5% funding fee, minimal documentation.

What is a VA IRRRL?
Exclusively for existing VA loan holders. Must result in a lower interest rate or convert ARM to fixed. cash_out must be 0 — any cash out converts to VA Cash-Out Refi (higher fees, full underwriting).

Scenario Parameters

Parameter	Value
Loan Purpose	Refinance (VA IRRRL)
Loan Type	VA
List Price	$450,001
Loan Amount	$360,001
LTV	~80%
Credit Score	780
State / City / ZIP	FL / Miami / 33130
Cash Out	$0
VA Funding Fee Type	First Time (0.5%)
Monthly Income	$12,000
loid	44

Request Payload

loan_type: "VA" (uppercase). cash_out: 0 required for IRRRL. va_funding_fee_type: "first_time" = 0.5% fee.

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

{
  "lock_period": 30,
  "first_time_homebuyer": false,
  "loan_type": "VA",
  "list_price": 450001,
  "loan_purpose": "refinance",
  "loan_amount": 360001,
  "credit_score": 780,
  "state": "FL",
  "city": "Miami",
  "zipcode": "33130",
  "coords": { "lat": 0, "lng": 0 },
  "residency_type": "primary_home",
  "property_type": "single_family_home",
  "cash_out": 0,
  "waive_escrows": false,
  "monthly_income": 12000,
  "va_funding_fee_type": "first_time",
  "loid": 6309,
  "id": 44,
  "withCredentials": false,
  "min_credit": 780,
  "loan_term": 30,
  "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,
    "loan_type": "VA",
    "list_price": 450001,
    "loan_purpose": "refinance",
    "loan_amount": 360001,
    "credit_score": 780,
    "state": "FL",
    "city": "Miami",
    "zipcode": "33130",
    "residency_type": "primary_home",
    "property_type": "single_family_home",
    "cash_out": 0,
    "monthly_income": 12000,
    "va_funding_fee_type": "first_time",
    "loid": 6309,
    "id": 44,
    "loan_term": 30,
    "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,
    loan_type: "VA",
    list_price: 450001,
    loan_purpose: "refinance",
    loan_amount: 360001,
    credit_score: 780,
    state: "FL",
    city: "Miami",
    zipcode: "33130",
    residency_type: "primary_home",
    property_type: "single_family_home",
    cash_out: 0,
    monthly_income: 12000,
    va_funding_fee_type: "first_time",
    loid: 6309,
    id: 44,
    loan_term: 30,
    aus: "NotSpecified"
  })
});
const data = await response.json();

Python (requests) Example

import requests

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

payload = {
  "lock_period": 30,
  "loan_type": "VA",
  "list_price": 450001,
  "loan_purpose": "refinance",
  "loan_amount": 360001,
  "credit_score": 780,
  "state": "FL",
  "city": "Miami",
  "zipcode": "33130",
  "residency_type": "primary_home",
  "property_type": "single_family_home",
  "cash_out": 0,
  "monthly_income": 12000,
  "va_funding_fee_type": "first_time",
  "loid": 6309,
  "id": 44,
  "loan_term": 30,
  "aus": "NotSpecified"
}

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

Sample Response Structure

VA responses include va_funding_fee and funding_fee_amount.

{
  "returncode": 0,
  "pricing_results": [
    {
      "rate": 6.250,
      "apr": 6.487,
      "va_funding_fee": 0.005,
      "funding_fee_amount": 1800.01
    },
    {
      "rate": 6.125,
      "points": 0.75,
      "va_funding_fee": 0.005,
      "funding_fee_amount": 1800.01
    }
  ]
}

VA IRRRL Field Reference:

• va_funding_fee_type: "first_time" = 0.5% IRRRL fee. "subsequent" for veterans who previously used VA. Disabled veterans may be exempt.
• cash_out: 0: Required for IRRRL. Non-zero triggers VA Cash-Out Refi (2.15%+ fee, full underwriting).
• aus: "NotSpecified": Appropriate — VA IRRRLs typically do not require AUS approval.