Projected return after renovating a property

GET /api/properties/renovation_return/

3 credits

What it returns

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.

When to use it

• Evaluate buy-and-fix-up opportunities.
• Compare renovation vs. cosmetic-only strategies on a single property.

Pricing

3 credits.

FAQ

What renovation scope is assumed?

The scope scales with the property's assessed condition and its state, not a fixed package: a property graded Poor is costed for far more work per square foot than one graded Good. The figure is Homesage.ai's stored renovation estimate for the property; without one it is square footage × a per-square-foot factor for that condition and state. Pass sqft to override the square footage when no stored estimate exists. For explicit room-level scope, use renovation-cost-breakdown.

How is ARV calculated?

From recent sales of comparable homes in good or excellent condition. The search starts at sales within 12 months and 2 miles and widens step by step to 24 months and 10 miles until 3 to 5 qualifying comps are found. Each sale price is adjusted to the subject's size by price per square foot, outliers are dropped, and the rest are averaged. With no qualifying comps, ARV falls back to 121% of the current estimated value. A computed ARV below the property's current value is lifted to just above it. See comps for the underlying comparable set.

How are the return figures calculated?

value_increase = ARV − pre-renovation value. net_return = value_increase − renovation cost. roi_percent = net_return ÷ renovation cost × 100. max_recommended_renovation_budget = 93% of ARV − pre-renovation value. Purchase, holding, selling, and financing costs are not charged here; flip-return charges the whole project. The cash_or_financed, downpayment, interest_rate, and loan_term query parameters are accepted and validated but do not change this endpoint's result.

Parameters

• property_address (query, required)
• 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).
• End-to-end fix-and-flip return projection — GET /api/properties/flip_return/
  A fix-and-flip return summary for the property — four numbers:
• 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.