End-to-end fix-and-flip return projection

GET /api/properties/flip_return/

3 credits

What it returns

A fix-and-flip return summary for the property — four numbers:

• total_project_cost — the all-in cost of the flip: purchase price, purchase costs, renovation, contingency, holding, and selling costs. Financing costs are added only when cash_or_financed=financed.
• profit — after-repair value (ARV) minus total_project_cost.
• resale_roi — profit as a percent of the project cost (see the FAQ for the exact denominator). Negative when the deal loses money.
• max_recommended_renovation_budget — the renovation spend that still leaves a 7%-of-ARV cushion above the property's current estimated value: 93% of ARV minus the current estimated value.

Differs from renovation-return, which values the renovation alone, by charging the whole project: purchase, holding, selling, and (optionally) financing.

When to use it

• Underwrite flip candidates with a standard model.
• Sort lead lists by projected flip ROI.

Pricing

3 credits.

FAQ

What purchase price does it assume?

The current listing price for an active listing. For an off-market property, the property's current estimated value stands in for the price.

What does the cost model include?

• Purchase costs: 3% of the purchase price.
• Renovation: Homesage.ai's stored renovation estimate for the property. Without one, square footage × a per-square-foot factor set by the property's assessed condition and its state.
• Contingency: 3% of the renovation estimate.
• Holding: 0.5% of the purchase price per month, for a 4-month project.
• Selling costs: 8% of ARV.

What financing terms are assumed?

None by default: the model is a cash purchase. Pass cash_or_financed=financed to add financing on a loan of the purchase price minus the downpayment percent (default 20%): 2 points on the loan plus 7% annual interest over the 4-month hold. interest_rate and loan_term are validated but do not change the result today.

Does it deduct agent commissions?

Yes. Selling costs are a flat 8% of ARV that covers agent commission and closing costs together; the two are not itemized.

How is resale_roi calculated?

Profit divided by the project cost excluding the contingency line, as a percent: -4.61 means −4.61%.

Where does ARV come from?

From recent sales of comparable homes in good or excellent condition, size-adjusted and averaged. See renovation-return for the method and comps for the comparable set.

Parameters

• property_address (query, required)
• cash_or_financed (query) — Purchase basis. cash (default) charges no financing. financed adds loan points and interest to the project cost; see the FAQ for the terms. Any other value returns 400.
• downpayment (query) — Down payment as a percent of the purchase price. Used only when cash_or_financed=financed; the loan is the remainder. Defaults to 20.
• interest_rate (query) — Annual interest rate in percent. Validated as a number but not used by the current flip model, which applies a fixed 7% on financed deals. Defaults to 4.5.
• loan_term (query) — Loan term in years. Validated as an integer but not used by the current flip model, which assumes a 4-month hold. Defaults to 30.
• sqft (query) — Overrides the property's square footage in the renovation estimate. Takes effect only when Homesage.ai has no stored renovation estimate for the property. A non-numeric value returns 400.

Responses

• 200
• 400 — Bad request — a required parameter is missing or failed validation. Costs 0 credits.
• 401 — Authentication failed — missing or invalid API key. Costs 0 credits.
• 402 — Payment required — no active subscription or insufficient credit balance. Costs 0 credits.
• 404 — Not found — the address could not be confidently matched to a single property. The body includes a did_you_mean array of suggested addresses (each with an mpr_id) to show the user and retry with; an empty array means no close match. Costs 0 credits.

More in Property Valuation

• Price Flexibility Score — how much room a listing has to negotiate — GET /api/properties/pfs/
  A Price Flexibility Score (PFS) for an active or recently-sold property — an estimate of how much price-negotiation room a listing has, derived from days-on-market, price-change history, comparable activity, and seasonal demand.
• Composite investor-grade investment-potential score — GET /api/properties/investment_potential/
  An Investment Potential score plus the component sub-scores it's built from (price relative to comps, cash-flow potential, appreciation trajectory, neighborhood risk).
• Projected return after renovating a property — GET /api/properties/renovation_return/
  Projected return from performing a standard renovation: pre-renovation estimated value (AVM), projected post-renovation ARV (After Repair Value), the renovation cost estimate (see renovation-cost for the aggregate figure and renovation-cost-breakdown for room-level detail), the value increase, net return, ROI percent, and the maximum recommended renovation budget.
• Historical AVM trajectory for a property — GET /api/properties/home_value_graph/
  A time-series of monthly AVM estimates for a property over the last 5 years.
• Does this property need TLC (fixer-upper indicator)? — GET /api/properties/tlc/
  A boolean / confidence-scored flag indicating whether the property is likely a fixer-upper — i.
• Long-term (12-month-lease) rental projection — GET /api/properties/rental/long_term/
  Projected long-term rental income — monthly rent band, vacancy assumption, gross operating income, net operating income after standard expense ratios, and capitalization rate vs.
• Short-term (Airbnb-style) rental projection — GET /api/properties/rental/short_term/
  Projected short-term rental performance — nightly rate band, expected occupancy, monthly gross income, net of typical expense ratios.
• Total renovation cost estimate (top-level) — GET /api/properties/renovation/cost/
  An aggregate estimated renovation cost for a property, plus the sqft basis and the per-sqft cost-of-construction model used.
• Homesage.ai AVM (current estimated value) for a property — GET /api/properties/current-estimate/
  The current Homesage.