<!-- https://staircase.co/data/property/layout -->
# layout

# layout

Rooms and spaces within a property, one record per space, with the physical characteristics of each.

<!--source:property-registry-->
The Layout class provides comprehensive documentation of individual rooms and spaces within a property, capturing detailed physical characteristics, design elements, and condition assessments.
<!--/source-->

The question it answers

## What is this house, physically?

The feature vector, taken from the source of record rather than from a listing agent. Assessor and parcel records are authoritative; listing fields are agent-entered, inconsistent between markets, and absent entirely for a property that was never listed.

Other classes answering this question

## Why it matters

Bedroom and bathroom counts are the headline, but the reason to decompose by space is that the counts alone are ambiguous. A finished basement bedroom, a converted garage and an addition are all bedrooms in a count and are not the same thing in a price.

## In practice

Each space carries its own dimensions, finish and condition, so a valuation can distinguish gross living area from total area under roof. The distinction matters because assessors and listings measure them differently, and a comparison that mixes the two is comparing different quantities.

The extraction is multi-building aware: a parcel with a main house and a detached accessory unit produces spaces for both rather than merging them.

## Properties

| Property | Type | Definition |
| --- | --- | --- |
| `source_http_request` | `object` | <!--source:property-registry-->HTTP request configuration for retrieving this data.<!--/source--> |
| `request_identifier` | `string | null` | <!--source:property-registry-->Identifier value that should be substituted into the source HTTP request to retrieve this specific data.<!--/source--> |
| `building_number` | `integer | null` | <!--source:property-registry-->The building number identifying which building the room or space is located in (useful for multi-building properties or complexes).<!--/source--> |
| `total_area_sq_ft` | `integer | null` | <!--source:property-registry-->Total enclosed building area in square feet, including all finished and unfinished spaces.<!--/source--> |
| `built_year` | `integer | null` | <!--source:property-registry-->The year in which the layout built.<!--/source--> |
| `adjustable_area_sq_ft` | `integer | null` | <!--source:property-registry-->Adjustable area in square feet used for planning or reconfiguration (e.g., flex or convertible spaces).<!--/source--> |
| `livable_area_sq_ft` | `integer | null` | <!--source:property-registry-->Heated living area in square feet (habitable space excluding garages, porches, and unfinished areas).<!--/source--> |
| `heated_area_sq_ft` | `integer | null` | <!--source:property-registry-->Heated area (served by permanent heating) in square feet. Typically overlaps living area under air.<!--/source--> |
| `area_under_air_sq_ft` | `integer | null` | <!--source:property-registry-->Air-conditioned area under air (A/C) in square feet.<!--/source--> |
| `story_type` | `string | null` | <!--source:property-registry-->Structural story classification if applicable `Full``Half Story``Three-Quarter Story`<!--/source--> |
| `space_type` | `string | null` | <!--source:property-registry-->The function or designation of the room. `Building``Living Room``Family Room``Great Room``Dining Room``Office Room``Conference Room``Class Room``Plant Floor``Kitchen``Breakfast Nook``Pantry``Primary Bedroom``Secondary Bedroom``Guest Bedroom``Children’s Bedroom``Nursery``Full Bathroom``Three-Quarter Bathroom``Half Bathroom / Powder Room``En-Suite Bathroom``Jack-and-Jill Bathroom``Primary Bathroom``Laundry Room``Mudroom``Closet``Bedroom``Walk-in Closet``Mechanical Room``Storage Room``Server/IT Closet``Home Office``Library``Den``Study``Media Room / Home Theater``Game Room``Home Gym``Music Room``Craft Room / Hobby Room``Prayer Room / Meditation Room``Safe Room / Panic Room``Wine Cellar``Bar Area``Greenhouse``Attached Garage``Detached Garage``Carport``Workshop``Storage Loft``Porch``Screened Porch``Sunroom``Deck``Patio``Pergola``Balcony``Terrace``Gazebo``Pool House``Outdoor Kitchen``Lobby / Entry Hall``Common Room``Utility Closet``Elevator Lobby``Mail Room``Janitor’s Closet``Pool Area``Indoor Pool``Outdoor Pool``Hot Tub / Spa Area``Shed``Lanai``Open Porch``Enclosed Porch``Attic``Enclosed Cabana``Carport``Attached Carport``Detached Carport``Detached Utility Closet``Jacuzzi``Courtyard``Open Courtyard``Screen Porch (1-Story)``Screen Enclosure (2-Story)``Screen Enclosure (3-Story)``Screen Enclosure (Custom)``Lower Garage``Lower Screened Porch``Screened Porch``Stoop``First Floor``Second Floor``Third Floor``Fourth Floor``Floor``Basement``Sub-Basement``Living Area``Barn`<!--/source--> |
| `space_index` | `integer` | <!--source:property-registry-->An index number representing the order of each space type in the property layout.<!--/source--> |
| `space_type_index` | `string` | <!--source:property-registry-->An index number representing the order of each space type and index in the property layout<!--/source--> |
| `flooring_material_type` | `string | null` | <!--source:property-registry-->Refers to the type of material used for a floor. `Manufactured``EngineeredWood``Terazzo``Brick``Wood``CinderBlock``Concrete``Shingle``Composition``Linoleum``Stone``CeramicTile``Block``WoodSiding``ImpactGlass``Carpet``Marble``Vinyl``Tile``PouredConcrete``Metal``Glass``Laminate`<!--/source--> |
| `size_square_feet` | `number | null` | <!--source:property-registry-->Room area in square feet.<!--/source--> |
| `floor_level` | `string | null` | <!--source:property-registry-->The floor level the room is on, useful for multi-story properties. `1st Floor``2nd Floor``3rd Floor``4th Floor`<!--/source--> |
| `has_windows` | `boolean | null` | <!--source:property-registry-->Whether the room has windows or not (relevant for egress and lighting).<!--/source--> |
| `window_design_type` | `string | null` | <!--source:property-registry-->Refers to the window design. `Skylights``Transom``Egress``Garden``Awning``DoubleHung``Jalousie``SingleHung``Sliding``Bay``Bow``Greenhouse``Picture``Casement`<!--/source--> |
| `window_material_type` | `string | null` | <!--source:property-registry-->Refers to the type of material a window is made from. `Manufactured``EngineeredWood``Terazzo``Brick``Wood``CinderBlock``Concrete``Shingle``Composition``Linoleum``Stone``CeramicTile``Block``WoodSiding``ImpactGlass``Carpet``Marble``Vinyl``Tile``PouredConcrete``Metal``Glass``Laminate`<!--/source--> |
| `window_treatment_type` | `string | null` | <!--source:property-registry-->Refers to the type of window treatment that covers the windows. `Blinds``Drapes``VerticalBlinds``HorizontalBlinds``Shades``PlantationShutters``CafeShutters``RollerShades``RomanShades``CellularHoneycombShades``SolarShades``PleatedShades``Curtains``BlackoutCurtains``ThermalCurtains``Valances``Cornices``WindowFilm``StainedGlass``BambooShades``WoodShades``WovenShades`<!--/source--> |
| `is_finished` | `boolean` | <!--source:property-registry-->Whether the room is finished (especially important for basements, attics, garages).<!--/source--> |
| `furnished` | `string | null` | <!--source:property-registry-->Indicates whether the room is furnished and to what extent. `Furnished``Unfurnished``Partially Furnished`<!--/source--> |
| `paint_condition` | `string | null` | <!--source:property-registry-->Visual state of paint within the room. `New``Good``Worn``Peeling`<!--/source--> |
| `flooring_wear` | `string | null` | <!--source:property-registry-->Observed condition of the flooring. `Pristine``Good``Moderate``Worn``Damaged`<!--/source--> |
| `clutter_level` | `string | null` | <!--source:property-registry-->Amount of visible clutter or personal items in the room. `Staged``Moderate``Heavy`<!--/source--> |
| `visible_damage` | `string | null` | <!--source:property-registry-->List of visible damage types (e.g. mold, stains, cracks, broken fixtures).<!--/source--> |
| `countertop_material` | `string | null` | <!--source:property-registry-->Material of visible countertops, if present. `Granite``Quartz``Marble``Laminate``Wood``Tile``Concrete`<!--/source--> |
| `cabinet_style` | `string | null` | <!--source:property-registry-->Visual cabinet style present in the room, if any. `Modern``Shaker``Traditional``Flat Panel``Glass Front`<!--/source--> |
| `fixture_finish_quality` | `string | null` | <!--source:property-registry-->`Basic``Mid-range``Luxury`<!--/source--> |
| `design_style` | `string | null` | <!--source:property-registry-->Dominant design style observed in the room. `Modern``Traditional``Rustic``Eclectic``Minimalist``Transitional`<!--/source--> |
| `natural_light_quality` | `string | null` | <!--source:property-registry-->Assessment of natural light availability. `Abundant``Moderate``Limited`<!--/source--> |
| `decor_elements` | `string | null` | <!--source:property-registry-->List of prominent design elements. `Vaulted Ceiling``Coffered Ceiling``Beamed Ceiling``Tray Ceiling``Accent Wall``Exposed Brick``Crown Molding``Wainscoting``Built-In Shelving``Wall Paneling`<!--/source--> |
| `pool_type` | `string | null` | <!--source:property-registry-->Specifies the structural or functional type of the pool if applicable to this room. `SaltWater``AboveGround``Concrete``Heated``BuiltIn``Plunge``Lap``Infinity``Fiberglass``Vinyl``Natural`<!--/source--> |
| `pool_equipment` | `string | null` | <!--source:property-registry-->List of visible pool-related equipment such as pumps, heaters, or covers.<!--/source--> |
| `spa_type` | `string | null` | <!--source:property-registry-->Specifies the type of spa or hot tub present, if applicable. `Jacuzzi``InGround``Rooftop``WoodFiredHotTub``JapaneseSoakingTub``Saltwater``Heated`<!--/source--> |
| `safety_features` | `string | null` | <!--source:property-registry-->Visible safety features such as fencing, alarms, slip-resistant surfaces, or pool covers. `Fencing``PoolCover``Alarm``SelfClosingGate``SlipResistantSurface``Lifebuoy``WarningSignage``SurveillanceCamera``Lighting`<!--/source--> |
| `view_type` | `string | null` | <!--source:property-registry-->The dominant view visible from this room. `Courtyard``Ocean``City``Garden``Bay``Marina``Mountain``Park``Waterfront``Street`<!--/source--> |
| `lighting_features` | `string | null` | <!--source:property-registry-->Observed lighting fixtures and types in room. `Recessed``Track``Pendant``Chandelier``FlushMount``WallSconces``NaturalLight``Skylight`<!--/source--> |
| `condition_issues` | `string | null` | <!--source:property-registry-->AI-observed visual condition issues in the room. `PeelingPaint``VisibleMold``WaterStains``DamagedDrywall``Clutter``Unfinished``Unclean``PersonalItemsVisible`<!--/source--> |
| `is_exterior` | `boolean` | <!--source:property-registry-->Indicates whether the space is exterior or interior.<!--/source--> |
| `pool_condition` | `string | null` | <!--source:property-registry-->Overall visible condition of the pool structure (tiles, lining, coping, etc.). `New``Good``Worn``Needs Repair``Damaged``Unknown`<!--/source--> |
| `pool_surface_type` | `string | null` | <!--source:property-registry-->The visible material or finish used for the pool’s interior surface. `Concrete``Tile``Vinyl Liner``Fiberglass``Painted``Natural Stone``Unknown`<!--/source--> |
| `pool_water_quality` | `string | null` | <!--source:property-registry-->The observed quality or clarity of the pool water in the image. `Clear``Slightly Cloudy``Cloudy``Green``Debris Present``Drained``Covered``Unknown`<!--/source--> |
| `kitchen_renovation_date` | `string | null` | <!--source:property-registry-->Date this kitchen was last remodeled (BLD/RES/COM).<!--/source--> |
| `bathroom_renovation_date` | `string | null` | <!--source:property-registry-->Date this bathroom was last remodeled (BLD/RES/COM/PLU/ELE).<!--/source--> |
| `installation_date` | `string | null` | <!--source:property-registry-->Date this layout/space was installed (BLD/RES/COM).<!--/source--> |
| `flooring_installation_date` | `string | null` | <!--source:property-registry-->Date flooring in this space was installed (BLD/RES/COM).<!--/source--> |
| `pool_installation_date` | `string | null` | <!--source:property-registry-->Date pool was installed (POL).<!--/source--> |
| `spa_installation_date` | `string | null` | <!--source:property-registry-->Date spa/hot tub was installed (POL/BLD).<!--/source--> |

## Provenance and coverage

A record of this class is validated against the same definition whatever jurisdiction it came from, which is what makes two counties comparable without a per-county adapter. A jurisdiction appears below only where a committed configuration serves this class's surface.

- Lee, Florida
- Palm Beach, Florida
- Miami-Dade, Florida
- Orange, Florida
- Santa Clara, California

How a new jurisdiction is brought online
