---
title: "Property Details"
method: GET
path: "/v2/property/details"
tags: ["Property Level"]
---

# Property Details

`GET /v2/property/details`

Access various property attributes from county assessor records, enabling comprehensive property profiling. 

Source: Public Records 

Pricing Tier: Basic 

Updated: Daily

## Request Query Params

<table><tr><th>Property</th><th>Type</th><th>Description</th><th>Example</th></tr>
<tr><td>slug</td><td>string</td><td>Unique readable string identifier for the property</td><td>123-Main-St-Apt-1B-San-Francisco-CA-94132</td>
        </tr>
<tr><td>address</td><td>string</td><td>Either a single URL-safe string ("slug") identifying the address, or just a building number, street name, and optionally unit number (if not a slug the payload must also include other identifiers)</td><td>123 Main St</td>
        </tr>
<tr><td>unit</td><td>string</td><td>Unit number for the property, if needed and not already specified in the address string</td><td>Apt 1B</td>
        </tr>
<tr><td>city</td><td>string</td><td>City in which the property is located</td><td>San Francisco</td>
        </tr>
<tr><td>state</td><td>string</td><td>2-letter acronym of the US state in which the property is located</td><td>CA</td>
        </tr>
<tr><td>zipcode</td><td>string</td><td>5-digit US zipcode in which the property is located</td><td>94105</td>
        </tr>
</table>

## Response

<table><tr><th>Field</th><th>Type</th><th>Description</th><th>Example</th><th>Enum Values</th></tr>
<tr><td>property</td><td>object</td><td>Property information sourced from county public record</td><td></td>
        <td></td></tr>
<tr><td>property.no_of_buildings</td><td>number</td><td>Number of buildings</td><td>2</td>
        <td></td></tr>
<tr><td>property.attic</td><td>boolean</td><td><code>true</code> if home has attic. <code>false</code> otherwise</td><td></td>
        <td></td></tr>
<tr><td>property.total_bath_count</td><td>number</td><td>Total bathroom count as recorded by the assessor</td><td>2.5</td>
        <td></td></tr>
<tr><td>property.full_bath_count</td><td>number</td><td>Count of full bathrooms as recorded by the assessor</td><td>2</td>
        <td></td></tr>
<tr><td>property.partial_bath_count</td><td>number</td><td>Partial bathroom count, if provided by the county assessor</td><td>0.5</td>
        <td></td></tr>
<tr><td>property.total_number_of_rooms</td><td>number</td><td>Total number of rooms in the property, including bedrooms, living rooms, kitchens, and other finished spaces. This does not include bathrooms</td><td>5</td>
        <td></td></tr>
<tr><td>property.heating</td><td>string</td><td>Type of heating unit. One of [<code>Yes</code>, <code>No</code>, </code><code>Baseboard</code>, <code>Central</code>, <code>Coal</code>, <code>Convection</code>, <code>Electric</code>, <code>Floor/Wall</code>, <code>Forced air unit</code>, <code>Gas</code>, <code>Geo-thermal</code>, <code>Gravity</code>, <code>Heat Pump</code>, <code>Hot Water</code>, <code>None</code>, <code>Oil</code>, <code>Other</code>, <code>Partial</code>, <code>Propane</code>, <code>Radiant</code>, <code>Solar</code>, <code>Space/Suspended</code>, <code>Steam</code>, <code>Vent</code>, <code>Wood Burning</code>, <code>Yes</code>, <code>Zone</code>]</td><td>forced_air_unit</td>
        <td>[yes, no, baseboard, central, coal, convection, electric, floor_wall, forced_air_unit, gas, geo_thermal, gravity, heat_pump, hot_water, none, oil, other, partial, propane, radiant, solar, space_suspended, steam, vent, wood_burning, yes, zone]</td></tr>
<tr><td>property.heating_fuel_type</td><td>string</td><td>Type of fuel or energy source used for the property’s primary heating system</td><td>gas</td>
        <td>[coal, electric, gas, geo_thermal, none, oil, propane]</td></tr>
<tr><td>property.style</td><td>string</td><td>Property architectural style. One of [<code>A-Frame</code>, <code>Bungalow</code>, <code>Cape Cod</code>, <code>Colonial</code>, <code>Contemporary</code>, <code>Conventional</code>, <code>Cottage</code>, <code>Custom</code>, <code>Dome</code>, <code>English</code>, <code>French Provincial</code>, <code>Georgian</code>, <code>High-rise</code>, <code>Historical</code>, <code>Log Cabin/Rustic</code>, <code>Mansion</code>, <code>Mediterranean</code>, <code>Modern</code>, <code>Other</code>, <code>Prefab</code>, <code>Modular</code>, <code>Raised Ranch</code>, <code>Ranch/Rambler</code>, <code>Spanish</code>, <code>Traditional</code>, <code>Tudor</code>, <code>Unfinished/Under Construction</code>, <code>Victorian</code>]</td><td>a_frame</td>
        <td>[a_frame, bungalow, cape_cod, colonial, contemporary, conventional, cottage, custom, dome, english, french_provincial, georgian, high_rise, historical, log_cabin_rustic, mansion, mediterranean, modern, other, prefab, modular, raised_ranch, ranch_rambler, spanish, traditional, tudor, unfinished_under_construction, victorian]</td></tr>
<tr><td>property.garage_parking_of_cars</td><td>number</td><td>Number of cars that can be parked in garage areas</td><td>1</td>
        <td></td></tr>
<tr><td>property.site_area_acres</td><td>number</td><td>Total area of the land in acres</td><td>2.5</td>
        <td></td></tr>
<tr><td>property.number_of_units</td><td>number</td><td>Number of units</td><td>20</td>
        <td></td></tr>
<tr><td>property.building_area_sq_ft</td><td>number</td><td>Area of building(s) in square feet</td><td>1974</td>
        <td></td></tr>
<tr><td>property.garage_type_parking</td><td>string</td><td>Type of parking area. One of [<code>Attached Garage</code>, <code>Built-in</code>, <code>Carport</code>, <code>Covered</code>, <code>Detached Garage</code>, <code>Garage</code>, <code>Mixed</code>, <code>None</code>, <code>Offsite</code>, <code>Open</code>, <code>Parking Lot</code>, <code>Parking Structure</code>, <code>Paved/Surfaced</code>, <code>Pole</code>, <code>Ramp</code>, <code>Tuckunder</code>, <code>Underground/Basement</code>, <code>Unimproved</code>, <code>Yes</code>]</td><td>carport</td>
        <td>[attached_garage, built_in, carport, covered, detached_garage, garage, mixed, none, offsite, open, parking_lot, parking_structure, paved_surfaced, pole, ramp, tuckunder, underground_basement, unimproved, yes]</td></tr>
<tr><td>property.basement</td><td>string</td><td>Description of basement. One of [<code>Full Basement</code>, <code>Daylight Full</code>, <code>Full</code>, <code>Improved Basement Finished</code>, <code>Daylight Partial</code>, <code>No Basement</code>, </code><code>Full Basement</code>, <code>No Basement</code>, <code>Partial Basement</code>, <code>Unfinished Basement</code>]</td><td>full_basement</td>
        <td>[full_basement, daylight_full, full, improved_basement_finished, daylight_partial, no_basement, full_basement, no_basement, partial_basement, unfinished_basement]</td></tr>
<tr><td>property.air_conditioning</td><td>string</td><td><code>yes</code> if home has air conditioning. <code>no</code> otherwise</td><td>yes</td>
        <td>[yes, no]</td></tr>
<tr><td>property.fireplace</td><td>string</td><td><code>true</code> if home has fireplace. <code>false</code> otherwise</td><td>gas</td>
        <td></td></tr>
<tr><td>property.pool</td><td>boolean</td><td>Whether the property has a pool</td><td>true</td>
        <td></td></tr>
<tr><td>property.no_of_stories</td><td>number</td><td>Number of floors</td><td>3</td>
        <td></td></tr>
<tr><td>property.water</td><td>string</td><td>Water connection. One of [<code>Cistern</code>, <code>Municipal</code>, <code>None</code>, <code>Spring</code>, <code>Well</code>, <code>Yes</code>]</td><td>municipal</td>
        <td>[cistern, municipal, none, spring, well, yes]</td></tr>
<tr><td>property.year_built</td><td>number</td><td>Year the property was constructed</td><td>2005</td>
        <td></td></tr>
<tr><td>property.exterior_walls</td><td>string</td><td>Type of exterior walls. One of [<code>Adobe</code>, <code>Asbestos shingle</code>, <code>Block</code>, <code>Brick</code>, <code>Brick veneer</code>, <code>Combination</code>, <code>Composition</code>, <code>Concrete</code>, <code>Concrete Block</code>, <code>Glass</code>, <code>Log</code>, <code>Marble</code>, <code>Masonry</code>, <code>Metal</code>, <code>Other</code>, <code>Rock</code>, <code>Stone</code>, <code>Shingle (Not Wood)</code>, <code>Siding (Alum/Vinyl)</code>, <code>Stucco</code>, <code>Tile</code>, <code>Tilt-up (pre-cast concrete)</code>, <code>Wood</code>, <code>Wood Shingle</code>, <code>Wood Siding</code>]</td><td>wood</td>
        <td>[adobe, asbestos_shingle, block, brick, brick_veneer, combination, composition, concrete, concrete_block, glass, log, marble, masonry, metal, other, rock, stone, shingle_not_wood, siding_alum_vinyl, stucco, tile, tilt_up_pre_cast_concrete, wood, wood_shingle, wood_siding]</td></tr>
<tr><td>property.number_of_bedrooms</td><td>number</td><td>Number of bedrooms</td><td>5</td>
        <td></td></tr>
<tr><td>property.sewer</td><td>string</td><td>Sewage connection. One of [<code>Municipal</code>, <code>None</code>, <code>Storm</code>, <code>Septic</code>, <code>Yes</code>]</td><td>public</td>
        <td>[municipal, none, storm, septic, yes]</td></tr>
<tr><td>property.property_type</td><td>string</td><td>Type of property</td><td>Single Family Residential</td>
        <td>[Single Family Residential, Townhouse, Condominium, Manufactured/Mobile Home, Multi-Family, Land, Timeshare, Commercial, Other]</td></tr>
<tr><td>property.subdivision</td><td>string</td><td>Subdivision as reported to the assessor</td><td>Pinecrest Estates</td>
        <td></td></tr>
<tr><td>property.building_quality_score</td><td>number</td><td>Possible building quality score. Values range from <code>1</code> to <code>5</code>. <code>5</code> = A grade, <code>4</code> = B grade, <code>4</code> = C grade, <code>2</code> = D grade, <code>1</code> = E grade</td><td>2</td>
        <td></td></tr>
<tr><td>property.building_condition_score</td><td>number</td><td>Possible building condition score. Values range from <code>1</code> to <code>5</code>. <code>5</code> = Excellent, <code>4</code> = Good, <code>3</code> = Fair, <code>2</code> = Poor, <code>1</code> = Unsound</td><td>2</td>
        <td></td></tr>
<tr><td>property.construction_type</td><td>string</td><td>Primary construction material. One of [<code>Adobe</code>, <code>Brick</code>, <code>Concrete</code>, <code>Concrete Block</code>, <code>Dome</code>, <code>Frame</code>, <code>Heavy</code>, <code>Light</code>, <code>Log</code>, <code>Manufactured</code>, <code>Other</code>, <code>Masonry</code>, <code>Metal</code>, <code>Steel</code>, <code>Stone</code>, <code>Tilt-up (pre-cast concrete)</code>, <code>Wood</code>, <code>Mixed</code>]</td><td>Dome</td>
        <td>[Adobe, Brick, Concrete, Concrete Block, Dome, Frame, Heavy, Light, Log, Manufactured, Other, Masonry, Metal, Steel, Stone, Tilt-up (pre-cast concrete), Wood, Mixed]</td></tr>
<tr><td>property.roof_cover</td><td>string</td><td>Material the roof is made of. One of [<code>Aluminum</code>, <code>Asbestos</code>, <code>Asphalt</code>, <code>Bermuda</code>, <code>Built-up</code>, <code>Composition Shingle</code>, <code>Concrete</code>, <code>Fiberglass</code>, <code>Gravel/Rock</code>, <code>Gypsum</code>, <code>Masonite/ Cement Shake</code>, <code>Metal</code>, <code>Other</code>, <code>Roll Composition</code>, <code>Slate</code>, <code>Steel</code>, <code>Shingle (Not Wood)</code>, <code>Tar & Gravel</code>, <code>Tile</code>, <code>Urethane</code>, <code>Wood</code>, <code>Wood Shake/ Shingles</code>]</td><td>Asphalt</td>
        <td>[Aluminum, Asbestos, Asphalt, Bermuda, Built-up, Composition Shingle, Concrete, Fiberglass, Gravel/Rock, Gypsum, Masonite/ Cement Shake, Metal, Other, Roll Composition, Slate, Steel, Shingle (Not Wood), Tar & Gravel, Tile, Urethane, Wood, Wood Shake/ Shingles]</td></tr>
<tr><td>property.roof_type</td><td>string</td><td>Roof structure. One of [<code>Bowstring Truss</code>, <code>Dome</code>,<code>Flat</code>, <code>Gable</code>, <code>Gable or Hip</code>, <code>Gambrel</code>, <code>Hip</code>, <code>Irr/Cathedral</code>, <code>Mansard</code>, <code>Prestress Concrete</code>, <code>Reinforced Concrete</code>, <code>Rigid frm bar JT</code>, <code>Sawtooth</code>, <code>Shed</code>, <code>Steel frm/truss</code>, <code>Wood Truss</code>]</td><td>Dome</td>
        <td>[Bowstring Truss, Dome, Flat, Gable, Gable or Hip, Gambrel, Hip, Irr/Cathedral, Mansard, Prestress Concrete, Reinforced Concrete, Rigid frm bar JT, Sawtooth, Shed, Steel frm/truss, Wood Truss]</td></tr>
<tr><td>property.zoning</td><td>string</td><td>County-specific property zoning</td><td>R-1 Residential</td>
        <td></td></tr>
<tr><td>assessment</td><td>object</td><td>Details about the most recent assessment</td><td></td>
        <td></td></tr>
<tr><td>assessment.apn</td><td>string</td><td>Assessor's Parcel Number or Parcel Identification Number</td><td>167-77-021</td>
        <td></td></tr>
<tr><td>assessment.assessment_year</td><td>number</td><td>Year the assessment was conducted</td><td>2023</td>
        <td></td></tr>
<tr><td>assessment.tax_amount</td><td>number</td><td>Amount in dollars of tax owed on the property</td><td>3500.75</td>
        <td></td></tr>
<tr><td>assessment.total_assessed_value</td><td>number</td><td>The total current assessed value of both land and improvements (before exemptions, if any) as reported on the county tax/assessment roll.</td><td>500000</td>
        <td></td></tr>
<tr><td>assessment.tax_year</td><td>number</td><td>Tax year for which the assessment applies</td><td>2022</td>
        <td></td></tr>
</table>

## Query parameters

- `slug` string
- `address` string, required
- `unit` string
- `city` string
- `state` string
- `zipcode` string

## Response `200`

Success

- object[]
  - `property/details` object
    - `api_code_description` string
    - `api_code` unknown
    - `result` object, nullable
      - `property` object — Property information sourced from county public record
        - `no_of_buildings` number, nullable — Number of buildings
        - `attic` boolean, nullable — <code>true</code> if home has attic. <code>false</code> otherwise
        - `total_bath_count` number, float — Total bathroom count as recorded by the assessor
        - `full_bath_count` number, nullable — Count of full bathrooms as recorded by the assessor
        - `partial_bath_count` number, float, nullable — Partial bathroom count, if provided by the county assessor
        - `total_number_of_rooms` number, nullable — Total number of rooms in the property, including bedrooms, living rooms, kitchens, and other finished spaces. This does not include bathrooms
        - `heating` 'yes' | 'no' | 'baseboard' | 'central' | 'coal' | 'convection' | 'electric' | 'floor_wall' | 'forced_air_unit' | 'gas' | 'geo_thermal' | 'gravity' | 'heat_pump' | 'hot_water' | 'none' | 'oil' | 'other' | 'partial' | 'propane' | 'radiant' | 'solar' | 'space_suspended' | 'steam' | 'vent' | 'wood_burning' | 'yes' | 'zone', nullable — Type of heating unit. One of [<code>Yes</code>, <code>No</code>, </code><code>Baseboard</code>, <code>Central</code>, <code>Coal</code>, <code>Convection</code>, <code>Electric</code>, <code>Floor/Wall</code>, <code>Forced air unit</code>, <code>Gas</code>, <code>Geo-thermal</code>, <code>Gravity</code>, <code>Heat Pump</code>, <code>Hot Water</code>, <code>None</code>, <code>Oil</code>, <code>Other</code>, <code>Partial</code>, <code>Propane</code>, <code>Radiant</code>, <code>Solar</code>, <code>Space/Suspended</code>, <code>Steam</code>, <code>Vent</code>, <code>Wood Burning</code>, <code>Yes</code>, <code>Zone</code>]
        - `heating_fuel_type` 'coal' | 'electric' | 'gas' | 'geo_thermal' | 'none' | 'oil' | 'propane', nullable — Type of fuel or energy source used for the property’s primary heating system
        - `style` 'a_frame' | 'bungalow' | 'cape_cod' | 'colonial' | 'contemporary' | 'conventional' | 'cottage' | 'custom' | 'dome' | 'english' | 'french_provincial' | 'georgian' | 'high_rise' | 'historical' | 'log_cabin_rustic' | 'mansion' | 'mediterranean' | 'modern' | 'other' | 'prefab' | 'modular' | 'raised_ranch' | 'ranch_rambler' | 'spanish' | 'traditional' | 'tudor' | 'unfinished_under_construction' | 'victorian', nullable — Property architectural style. One of [<code>A-Frame</code>, <code>Bungalow</code>, <code>Cape Cod</code>, <code>Colonial</code>, <code>Contemporary</code>, <code>Conventional</code>, <code>Cottage</code>, <code>Custom</code>, <code>Dome</code>, <code>English</code>, <code>French Provincial</code>, <code>Georgian</code>, <code>High-rise</code>, <code>Historical</code>, <code>Log Cabin/Rustic</code>, <code>Mansion</code>, <code>Mediterranean</code>, <code>Modern</code>, <code>Other</code>, <code>Prefab</code>, <code>Modular</code>, <code>Raised Ranch</code>, <code>Ranch/Rambler</code>, <code>Spanish</code>, <code>Traditional</code>, <code>Tudor</code>, <code>Unfinished/Under Construction</code>, <code>Victorian</code>]
        - `garage_parking_of_cars` number, nullable — Number of cars that can be parked in garage areas
        - `site_area_acres` number, float — Total area of the land in acres
        - `number_of_units` number, nullable — Number of units
        - `building_area_sq_ft` number, nullable — Area of building(s) in square feet
        - `garage_type_parking` 'attached_garage' | 'built_in' | 'carport' | 'covered' | 'detached_garage' | 'garage' | 'mixed' | 'none' | 'offsite' | 'open' | 'parking_lot' | 'parking_structure' | 'paved_surfaced' | 'pole' | 'ramp' | 'tuckunder' | 'underground_basement' | 'unimproved' | 'yes', nullable — Type of parking area. One of [<code>Attached Garage</code>, <code>Built-in</code>, <code>Carport</code>, <code>Covered</code>, <code>Detached Garage</code>, <code>Garage</code>, <code>Mixed</code>, <code>None</code>, <code>Offsite</code>, <code>Open</code>, <code>Parking Lot</code>, <code>Parking Structure</code>, <code>Paved/Surfaced</code>, <code>Pole</code>, <code>Ramp</code>, <code>Tuckunder</code>, <code>Underground/Basement</code>, <code>Unimproved</code>, <code>Yes</code>]
        - `basement` 'full_basement' | 'daylight_full' | 'full' | 'improved_basement_finished' | 'daylight_partial' | 'no_basement' | 'full_basement' | 'no_basement' | 'partial_basement' | 'unfinished_basement', nullable — Description of basement. One of [<code>Full Basement</code>, <code>Daylight Full</code>, <code>Full</code>, <code>Improved Basement Finished</code>, <code>Daylight Partial</code>, <code>No Basement</code>, </code><code>Full Basement</code>, <code>No Basement</code>, <code>Partial Basement</code>, <code>Unfinished Basement</code>]
        - `air_conditioning` 'yes' | 'no', nullable — <code>yes</code> if home has air conditioning. <code>no</code> otherwise
        - `fireplace` string, nullable — <code>true</code> if home has fireplace. <code>false</code> otherwise
        - `pool` boolean, nullable — Whether the property has a pool
        - `no_of_stories` number, nullable — Number of floors
        - `water` 'cistern' | 'municipal' | 'none' | 'spring' | 'well' | 'yes', nullable — Water connection. One of [<code>Cistern</code>, <code>Municipal</code>, <code>None</code>, <code>Spring</code>, <code>Well</code>, <code>Yes</code>]
        - `year_built` number — Year the property was constructed
        - `exterior_walls` 'adobe' | 'asbestos_shingle' | 'block' | 'brick' | 'brick_veneer' | 'combination' | 'composition' | 'concrete' | 'concrete_block' | 'glass' | 'log' | 'marble' | 'masonry' | 'metal' | 'other' | 'rock' | 'stone' | 'shingle_not_wood' | 'siding_alum_vinyl' | 'stucco' | 'tile' | 'tilt_up_pre_cast_concrete' | 'wood' | 'wood_shingle' | 'wood_siding', nullable — Type of exterior walls. One of [<code>Adobe</code>, <code>Asbestos shingle</code>, <code>Block</code>, <code>Brick</code>, <code>Brick veneer</code>, <code>Combination</code>, <code>Composition</code>, <code>Concrete</code>, <code>Concrete Block</code>, <code>Glass</code>, <code>Log</code>, <code>Marble</code>, <code>Masonry</code>, <code>Metal</code>, <code>Other</code>, <code>Rock</code>, <code>Stone</code>, <code>Shingle (Not Wood)</code>, <code>Siding (Alum/Vinyl)</code>, <code>Stucco</code>, <code>Tile</code>, <code>Tilt-up (pre-cast concrete)</code>, <code>Wood</code>, <code>Wood Shingle</code>, <code>Wood Siding</code>]
        - `number_of_bedrooms` number, nullable — Number of bedrooms
        - `sewer` 'municipal' | 'none' | 'storm' | 'septic' | 'yes', nullable — Sewage connection. One of [<code>Municipal</code>, <code>None</code>, <code>Storm</code>, <code>Septic</code>, <code>Yes</code>]
        - `property_type` 'Single Family Residential' | 'Townhouse' | 'Condominium' | 'Manufactured/Mobile Home' | 'Multi-Family' | 'Land' | 'Timeshare' | 'Commercial' | 'Other' — Type of property
        - `subdivision` string — Subdivision as reported to the assessor
        - `building_quality_score` number, nullable — Possible building quality score. Values range from <code>1</code> to <code>5</code>. <code>5</code> = A grade, <code>4</code> = B grade, <code>4</code> = C grade, <code>2</code> = D grade, <code>1</code> = E grade
        - `building_condition_score` number — Possible building condition score. Values range from <code>1</code> to <code>5</code>. <code>5</code> = Excellent, <code>4</code> = Good, <code>3</code> = Fair, <code>2</code> = Poor, <code>1</code> = Unsound
        - `construction_type` 'Adobe' | 'Brick' | 'Concrete' | 'Concrete Block' | 'Dome' | 'Frame' | 'Heavy' | 'Light' | 'Log' | 'Manufactured' | 'Other' | 'Masonry' | 'Metal' | 'Steel' | 'Stone' | 'Tilt-up (pre-cast concrete)' | 'Wood' | 'Mixed', nullable — Primary construction material. One of [<code>Adobe</code>, <code>Brick</code>, <code>Concrete</code>, <code>Concrete Block</code>, <code>Dome</code>, <code>Frame</code>, <code>Heavy</code>, <code>Light</code>, <code>Log</code>, <code>Manufactured</code>, <code>Other</code>, <code>Masonry</code>, <code>Metal</code>, <code>Steel</code>, <code>Stone</code>, <code>Tilt-up (pre-cast concrete)</code>, <code>Wood</code>, <code>Mixed</code>]
        - `roof_cover` 'Aluminum' | 'Asbestos' | 'Asphalt' | 'Bermuda' | 'Built-up' | 'Composition Shingle' | 'Concrete' | 'Fiberglass' | 'Gravel/Rock' | 'Gypsum' | 'Masonite/ Cement Shake' | 'Metal' | 'Other' | 'Roll Composition' | 'Slate' | 'Steel' | 'Shingle (Not Wood)' | 'Tar & Gravel' | 'Tile' | 'Urethane' | 'Wood' | 'Wood Shake/ Shingles', nullable — Material the roof is made of. One of [<code>Aluminum</code>, <code>Asbestos</code>, <code>Asphalt</code>, <code>Bermuda</code>, <code>Built-up</code>, <code>Composition Shingle</code>, <code>Concrete</code>, <code>Fiberglass</code>, <code>Gravel/Rock</code>, <code>Gypsum</code>, <code>Masonite/ Cement Shake</code>, <code>Metal</code>, <code>Other</code>, <code>Roll Composition</code>, <code>Slate</code>, <code>Steel</code>, <code>Shingle (Not Wood)</code>, <code>Tar & Gravel</code>, <code>Tile</code>, <code>Urethane</code>, <code>Wood</code>, <code>Wood Shake/ Shingles</code>]
        - `roof_type` 'Bowstring Truss' | 'Dome' | 'Flat' | 'Gable' | 'Gable or Hip' | 'Gambrel' | 'Hip' | 'Irr/Cathedral' | 'Mansard' | 'Prestress Concrete' | 'Reinforced Concrete' | 'Rigid frm bar JT' | 'Sawtooth' | 'Shed' | 'Steel frm/truss' | 'Wood Truss', nullable — Roof structure. One of [<code>Bowstring Truss</code>, <code>Dome</code>,<code>Flat</code>, <code>Gable</code>, <code>Gable or Hip</code>, <code>Gambrel</code>, <code>Hip</code>, <code>Irr/Cathedral</code>, <code>Mansard</code>, <code>Prestress Concrete</code>, <code>Reinforced Concrete</code>, <code>Rigid frm bar JT</code>, <code>Sawtooth</code>, <code>Shed</code>, <code>Steel frm/truss</code>, <code>Wood Truss</code>]
        - `zoning` string — County-specific property zoning
      - `assessment` object — Details about the most recent assessment
        - `apn` string — Assessor's Parcel Number or Parcel Identification Number
        - `assessment_year` number — Year the assessment was conducted
        - `tax_amount` number — Amount in dollars of tax owed on the property
        - `total_assessed_value` number — The total current assessed value of both land and improvements (before exemptions, if any) as reported on the county tax/assessment roll.
        - `tax_year` number — Tax year for which the assessment applies
  - `address_info` AddressInfo
    - `address_full` string, nullable — Full address string
    - `slug` string, nullable — HouseCanary address slug
    - `address` string, nullable — Street address
    - `unit` string, nullable — Unit within the building, if any
    - `city` string, nullable — City where property is located
    - `state` string, nullable — 2-character state abbreviation
    - `zipcode` string, nullable — 5-character US zipcode
    - `zipcode_plus4` string, nullable — 4-character zipcode extension
    - `block_id` string, nullable — 15-digit US census block ID
    - `blockgroup_id` string, nullable — 12-digit census block group ID
    - `county_fips` string, nullable — 5-digit US census county ID
    - `metrodiv` string, nullable — 5-digit US census Metropolitan Division ID
    - `msa` string, nullable — 5-digit US census MSA ID
    - `geo_precision` 'rooftop' | 'parcel' | 'zip9' | 'zip5' | 'unknown', nullable — A string describing available geo precision
    - `lat` number, nullable — Latitude value, in degrees
    - `lng` number, nullable — Longitude value, in degrees
    - `status` object
      - `match` boolean — Whether the address was matched to a canonical address in HouseCanary's systems
      - `details` string[]
      - `requested_item` object — Exact address parameters provided in the original API request
      - `changes` string[]
      - `errors` string[]

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/housecanary/apis/housecanary-analytics-and-portfolio-monitoring-apis.md) · [All operations](https://skmtc.net/housecanary/apis/housecanary-analytics-and-portfolio-monitoring-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/housecanary/housecanary-analytics-and-portfolio-monitoring-apis/revisions/38afb6724de7/schema)