AI-powered square-footage breakdown by floor

GET /api/properties/sqft-per-floor/

1 credit

What it returns

Per-floor square-footage distribution for a US residential property, derived from a multi-stage AI analysis (photo/room detection, architectural-style inference, and multi-method validation). Returns the total square footage and a square_feet_by_floor map keyed by floor.

When to use it

• Break out living area by floor for renovation, valuation, or listing copy.
• Sanity-check a single total-sqft figure against a per-floor split.

Note: this is a heavy AI workflow — use a 45-second client timeout.

Costs 1 credit per call.

Parameters

• address (query, required) — Full US property address. Example: 4411 E Hidden Oak St Springfield MO 65802.

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 AI-Powered Analysis

• Composite full property report — everything aggregated — GET /api/properties/full-report/
  The most comprehensive property analysis endpoint — aggregates 11 internal sources into a single response with 292 data fields.
• AI-derived property condition score from listing photos — GET /api/properties/property-condition/
  An AI condition assessment for a US residential property — overall condition category (Excellent/Good/Fair/Poor), confidence score, per-room breakdown when photos are available, and any flags (water damage, deferred maintenance signals).
• Property condition analysis with your own photos — POST /api/properties/property-condition-custom-photos/
  An overall property-condition rating and confidence score, combining a database lookup with AI vision analysis of property photos you supply.
• Comparable sold properties (comps) for a subject property — GET /api/properties/comps/
  A ranked list of comparable sold properties within a search radius of the subject — each comp scored on similarity (size, beds/baths, year built, distance, condition delta) with the sale price and date.
• LLM-powered room-by-room renovation cost breakdown — POST /api/properties/renovation-cost-breakdown/
  An itemized room-by-room renovation cost breakdown powered by a multimodal LLM analyzing the property's images plus its size/feature metadata.
• Local market outlook (buyer's/balanced/seller's) for a ZIP — GET /api/properties/market-outlook/
  A composite Market Outlook score (0-100) classifying a ZIP code as a buyer's market (<40), balanced (40-60), or seller's market (>60).
• Solar potential + AI roof condition for a property — GET /api/solar/analysis/
  Two coupled analyses in one call: