Property Details Advanced
Access various property attributes from county assessor records, enabling comprehensive property profiling, along with HouseCanary data with additional information
Source: HouseCanary, Public Records
Pricing Tier: Basic
Updated: Daily
Request Query Params
<table><tr><th>Property</th><th>Type</th><th>Description</th><th>Example</th><th>Enum Values</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> <td></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> <td></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> <td></td></tr> <tr><td>city</td><td>string</td><td>City in which the property is located</td><td>San Francisco</td> <td></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> <td></td></tr> <tr><td>zipcode</td><td>string</td><td>5-digit US zipcode in which the property is located</td><td>94105</td> <td></td></tr> <tr><td>type</td><td>string</td><td>Specify which results are returned updated</td><td></td> <td>[hc, public, both]</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>subject_address</td><td>object</td><td></td><td></td> <td></td></tr> <tr><td>subject_address.address_full</td><td>string</td><td>Full address string</td><td>123 Main St San Francisco CA 94132</td> <td></td></tr> <tr><td>subject_address.address_id</td><td>integer</td><td>HouseCanary address identifier</td><td>34343343</td> <td></td></tr> <tr><td>subject_address.slug</td><td>string</td><td>HouseCanary address slug</td><td>123-Main-St-Apt-1B-San-Francisco-CA-94132</td> <td></td></tr> <tr><td>subject_address.block_id</td><td>string</td><td>15-digit US census block ID</td><td>060750313013007</td> <td></td></tr> <tr><td>subject_address.city</td><td>string</td><td>City where property is located</td><td>San Francisco</td> <td></td></tr> <tr><td>subject_address.fips</td><td>string</td><td>5-digit US census county ID</td><td>06075</td> <td></td></tr> <tr><td>subject_address.geo_precision</td><td>string</td><td>A string describing available geo precision</td><td>rooftop</td> <td>[rooftop, parcel, zip9, zip5, unknown]</td></tr> <tr><td>subject_address.latitude</td><td>number</td><td>Latitude value, in degrees</td><td>37.789</td> <td></td></tr> <tr><td>subject_address.longitude</td><td>number</td><td>Longitude value, in degrees</td><td>-122.401</td> <td></td></tr> <tr><td>subject_address.state</td><td>string</td><td>2-character state abbreviation</td><td>CA</td> <td></td></tr> <tr><td>subject_address.unit</td><td>string</td><td>Unit within the building, if any</td><td>Apt 1B</td> <td></td></tr> <tr><td>subject_address.address</td><td>string</td><td>Street address</td><td>123 Main St</td> <td></td></tr> <tr><td>subject_address.zipcode</td><td>string</td><td>5-character US zipcode</td><td>94132</td> <td></td></tr> <tr><td>subject_address.zipcode_plus4</td><td>string</td><td>4-character zipcode extension</td><td>1234</td> <td></td></tr> <tr><td>subject_address.msa</td><td>string</td><td>5-digit US census MSA ID</td><td>41860</td> <td></td></tr> <tr><td>public_records</td><td>object</td><td>Public Record information</td><td></td> <td></td></tr> <tr><td>public_records.architectural_style</td><td>string</td><td>Architectural style of the property</td><td>Colonial</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, RanchRambler, Spanish, Traditional, Tudor, Unfinished/Under Construction, Victorian]</td></tr> <tr><td>public_records.attic</td><td>string</td><td>Attic information</td><td>Finished</td> <td></td></tr> <tr><td>public_records.basement</td><td>object</td><td>Basement details</td><td></td> <td></td></tr> <tr><td>public_records.basement.finished_pct</td><td>number</td><td>Percentage of finished basement</td><td>75.5</td> <td></td></tr> <tr><td>public_records.basement.has</td><td>boolean</td><td>Indicates if the property has a basement</td><td>true</td> <td></td></tr> <tr><td>public_records.basement.total_area</td><td>number</td><td>Total basement area</td><td>1200</td> <td></td></tr> <tr><td>public_records.bathrooms</td><td>object</td><td>Bathroom information</td><td></td> <td></td></tr> <tr><td>public_records.bathrooms.full</td><td>integer</td><td>Number of full bathrooms</td><td>2</td> <td></td></tr> <tr><td>public_records.bathrooms.partial</td><td>integer</td><td>Number of partial bathrooms</td><td>1</td> <td></td></tr> <tr><td>public_records.bathrooms.total</td><td>number</td><td>Total number of bathrooms</td><td>2.5</td> <td></td></tr> <tr><td>public_records.bathrooms.total_provided</td><td>string</td><td>Total number of bathrooms provided</td><td>3</td> <td></td></tr> <tr><td>public_records.bathrooms.total_projected</td><td>number</td><td>Total number of projected bathrooms</td><td>3.5</td> <td></td></tr> <tr><td>public_records.bedrooms</td><td>integer</td><td>Number of bedrooms</td><td>4</td> <td></td></tr> <tr><td>public_records.buildings</td><td>integer</td><td>Number of buildings</td><td>1</td> <td></td></tr> <tr><td>public_records.building_quality</td><td>string</td><td>Quality of the building</td><td>Excellent</td> <td></td></tr> <tr><td>public_records.building_condition_code</td><td>string</td><td>Condition of the building</td><td>Excellent</td> <td></td></tr> <tr><td>public_records.construction_types</td><td>array</td><td>Types of construction</td><td></td> <td></td></tr> <tr><td>public_records.construction_types[]</td><td>string</td><td></td><td>Wood Frame</td> <td></td></tr> <tr><td>public_records.cooling</td><td>array</td><td>Cooling systems used</td><td></td> <td></td></tr> <tr><td>public_records.cooling[]</td><td>string</td><td></td><td>Central Air</td> <td></td></tr> <tr><td>public_records.fireplace</td><td>string</td><td>Fireplace information</td><td>Gas</td> <td></td></tr> <tr><td>public_records.fireplaces_total</td><td>integer</td><td>Total number of fireplaces</td><td>1</td> <td></td></tr> <tr><td>public_records.heating</td><td>array</td><td>Heating systems used</td><td></td> <td></td></tr> <tr><td>public_records.heating[]</td><td>string</td><td></td><td>Forced air unit</td> <td>[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>public_records.legal_description</td><td>string</td><td>Legal description of the property</td><td>Lot 123, Block A, Subdivision X</td> <td></td></tr> <tr><td>public_records.living_area</td><td>number</td><td>Total living area of the property (square feet)</td><td>2400.4</td> <td></td></tr> <tr><td>public_records.living_area_above_grade</td><td>string</td><td>Total living area of the property above grade (square feet)</td><td>1800</td> <td></td></tr> <tr><td>public_records.living_area_below_grade</td><td>string</td><td>Total living area of the property below grade (square feet)</td><td>1800</td> <td></td></tr> <tr><td>public_records.lot_size</td><td>number</td><td>Size of the lot (square feet)</td><td>10000</td> <td></td></tr> <tr><td>public_records.neighborhood</td><td>string</td><td>Neighborhood information</td><td>Suburban</td> <td></td></tr> <tr><td>public_records.parcel_id</td><td>string</td><td>Identifier for the parcel on which the property sits</td><td>1829264TC000011000060A</td> <td></td></tr> <tr><td>public_records.parking</td><td>object</td><td>Parking information</td><td></td> <td></td></tr> <tr><td>public_records.parking.description</td><td>string</td><td>Description of parking</td><td>Attached Garage</td> <td></td></tr> <tr><td>public_records.parking.garage</td><td>integer</td><td>Number of garage spaces</td><td>2</td> <td></td></tr> <tr><td>public_records.parking.total</td><td>integer</td><td>Total number of parking spaces</td><td>4</td> <td></td></tr> <tr><td>public_records.pool</td><td>boolean</td><td>Has a pool</td><td>true</td> <td></td></tr> <tr><td>public_records.pool_community</td><td>boolean</td><td>Whether the property is part of a community with a shared pool</td><td>1829264TC000011000060A</td> <td></td></tr> <tr><td>public_records.property_type</td><td>string</td><td>Type of property</td><td>SFR</td> <td>[SFR, Townhouse, Condominium, Manufactured/Mobile Home, Multi-Family, Land, Timeshare, Commercial, Other]</td></tr> <tr><td>public_records.property_type_description</td><td>string</td><td>A description of the property type</td><td>Single Family Residential</td> <td></td></tr> <tr><td>public_records.roof_material</td><td>string</td><td>The roofing material used on the main structure</td><td>Composition Shingle</td> <td></td></tr> <tr><td>public_records.roof_type</td><td>string</td><td>Type of roof</td><td>Gable</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>public_records.rooms_total</td><td>integer</td><td>Total number of rooms</td><td>8</td> <td></td></tr> <tr><td>public_records.sewer</td><td>boolean</td><td>The type of sewer system on the property</td><td>Public</td> <td></td></tr> <tr><td>public_records.sewer_public</td><td>boolean</td><td>Whether the property is connected to a public sewer system</td><td>true</td> <td></td></tr> <tr><td>public_records.solar_panels</td><td>boolean</td><td>Whether solar panels are installed</td><td>true</td> <td></td></tr> <tr><td>public_records.stories</td><td>integer</td><td>Number of above-grade levels of the main structure</td><td>2</td> <td></td></tr> <tr><td>public_records.subdivision</td><td>boolean</td><td>Whether the property is part of a subdivision</td><td>true</td> <td></td></tr> <tr><td>public_records.units_total</td><td>integer</td><td></td><td>2</td> <td></td></tr> <tr><td>public_records.walls_exterior_material</td><td>string</td><td></td><td>Stucco</td> <td></td></tr> <tr><td>public_records.water</td><td>string</td><td>The source of the property's water supply</td><td>City water</td> <td></td></tr> <tr><td>public_records.year_built</td><td>integer</td><td>Year the property was built</td><td>1995</td> <td></td></tr> <tr><td>public_records.zoning</td><td>object</td><td>Zoning information</td><td></td> <td></td></tr> <tr><td>public_records.zoning.code</td><td>string</td><td>The zoning code of the property</td><td>R-1</td> <td></td></tr> <tr><td>public_records.zoning.description</td><td>string</td><td>Description of zoning</td><td>This property is zoned as R-1, which designates it for single-family residential use</td> <td></td></tr> <tr><td>hc</td><td>object</td><td>HouseCanary information</td><td></td> <td></td></tr> <tr><td>hc.architectural_style</td><td>string</td><td>Architectural style of the property</td><td>Contemporary</td> <td></td></tr> <tr><td>hc.attic</td><td>string</td><td>Attic information</td><td>Unfinished</td> <td></td></tr> <tr><td>hc.basement</td><td>object</td><td>Basement details</td><td></td> <td></td></tr> <tr><td>hc.basement.finished_pct</td><td>number</td><td>Percentage of finished basement</td><td>50.2</td> <td></td></tr> <tr><td>hc.basement.has</td><td>boolean</td><td>Indicates if the property has a basement</td><td></td> <td></td></tr> <tr><td>hc.basement.total_area</td><td>number</td><td>Total basement area</td><td>900</td> <td></td></tr> <tr><td>hc.bathrooms</td><td>object</td><td>Bathroom information</td><td></td> <td></td></tr> <tr><td>hc.bathrooms.full</td><td>integer</td><td>Number of full bathrooms</td><td>3</td> <td></td></tr> <tr><td>hc.bathrooms.partial</td><td>integer</td><td>Number of partial bathrooms</td><td>1</td> <td></td></tr> <tr><td>hc.bathrooms.total</td><td>number</td><td>Total number of bathrooms</td><td>3.5</td> <td></td></tr> <tr><td>hc.bathrooms.total_provided</td><td>string</td><td>Total number of bathrooms provided</td><td>4</td> <td></td></tr> <tr><td>hc.bathrooms.total_projected</td><td>number</td><td>Total number of projected bathrooms</td><td>4.5</td> <td></td></tr> <tr><td>hc.bedrooms</td><td>integer</td><td>Number of bedrooms</td><td>3</td> <td></td></tr> <tr><td>hc.buildings</td><td>integer</td><td>Number of buildings</td><td>1</td> <td></td></tr> <tr><td>hc.building_quality</td><td>string</td><td>Quality of the building</td><td>Good</td> <td></td></tr> <tr><td>hc.condition_class</td><td>integer</td><td>The current condition rating of the property as determined by HouseCanary</td><td>C4</td> <td></td></tr> <tr><td>hc.construction_types</td><td>array</td><td>Types of construction</td><td></td> <td></td></tr> <tr><td>hc.construction_types[]</td><td>string</td><td></td><td>Brick</td> <td></td></tr> <tr><td>hc.cooling</td><td>array</td><td>Cooling systems used</td><td></td> <td></td></tr> <tr><td>hc.cooling[]</td><td>string</td><td></td><td>Ductless Mini Split</td> <td></td></tr> <tr><td>hc.fireplace</td><td>string</td><td>Fireplace information</td><td>Wood Burning</td> <td></td></tr> <tr><td>hc.fireplaces_total</td><td>integer</td><td>Total number of fireplaces</td><td>2</td> <td></td></tr> <tr><td>hc.heating</td><td>array</td><td>Heating systems used</td><td></td> <td></td></tr> <tr><td>hc.heating[]</td><td>string</td><td></td><td>Radiant Heat</td> <td>[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>hc.legal_description</td><td>string</td><td>Legal description of the property</td><td>Lot 456, Block B, Subdivision Y</td> <td></td></tr> <tr><td>hc.living_area</td><td>number</td><td>Total living area of the property (square feet)</td><td>1800.4</td> <td></td></tr> <tr><td>hc.living_area_above_grade</td><td>string</td><td>Total living area of the property above grade (square feet)</td><td>1800</td> <td></td></tr> <tr><td>hc.living_area_below_grade</td><td>string</td><td>Total living area of the property below grade (square feet)</td><td>1800</td> <td></td></tr> <tr><td>hc.lot_size</td><td>integer</td><td>Size of the lot (square feet)</td><td>7500</td> <td></td></tr> <tr><td>hc.neighborhood</td><td>string</td><td>Neighborhood information</td><td>Urban</td> <td></td></tr> <tr><td>hc.parcel_id</td><td>string</td><td>Identifier for the parcel on which the property sits</td><td>1829264TC000011000060A</td> <td></td></tr> <tr><td>hc.parking</td><td>object</td><td>Parking information</td><td></td> <td></td></tr> <tr><td>hc.parking.description</td><td>string</td><td>Description of parking</td><td>Attached Garage</td> <td></td></tr> <tr><td>hc.parking.garage</td><td>integer</td><td>Number of garage spaces</td><td>2</td> <td></td></tr> <tr><td>hc.parking.total</td><td>integer</td><td>Total number of parking spaces</td><td>4</td> <td></td></tr> <tr><td>hc.pool</td><td>boolean</td><td>Has a pool</td><td>true</td> <td></td></tr> <tr><td>hc.pool_community</td><td>boolean</td><td>Whether the property is part of a community with a shared pool</td><td>1829264TC000011000060A</td> <td></td></tr> <tr><td>hc.property_type</td><td>string</td><td>Type of property</td><td>Condo</td> <td></td></tr> <tr><td>hc.property_type_description</td><td>string</td><td>A description of the property type</td><td>Single Family Residential</td> <td></td></tr> <tr><td>hc.roof_material</td><td>string</td><td>The roofing material used on the main structure</td><td>Composition Shingle</td> <td></td></tr> <tr><td>hc.roof_type</td><td>string</td><td>Type of roof</td><td>Hip</td> <td></td></tr> <tr><td>hc.rooms_total</td><td>integer</td><td>Total number of rooms</td><td>6</td> <td></td></tr> <tr><td>hc.sewer</td><td>boolean</td><td>The type of sewer system on the property</td><td>Public</td> <td></td></tr> <tr><td>hc.sewer_public</td><td>boolean</td><td>Whether the property is connected to a public sewer system</td><td>true</td> <td></td></tr> <tr><td>hc.solar_panels</td><td>boolean</td><td>Whether solar panels are installed</td><td>true</td> <td></td></tr> <tr><td>hc.stories</td><td>integer</td><td>Number of above-grade levels of the main structure</td><td>2</td> <td></td></tr> <tr><td>hc.subdivision</td><td>boolean</td><td>Whether the property is part of a subdivision</td><td>true</td> <td></td></tr> <tr><td>hc.units_total</td><td>integer</td><td></td><td>2</td> <td></td></tr> <tr><td>hc.walls_exterior_material</td><td>string</td><td></td><td>Stucco</td> <td></td></tr> <tr><td>hc.water</td><td>string</td><td>The source of the property's water supply</td><td>City water</td> <td></td></tr> <tr><td>hc.year_built</td><td>integer</td><td>Year the property was built</td><td>2008</td> <td></td></tr> <tr><td>hc.zoning</td><td>object</td><td>Zoning information</td><td></td> <td></td></tr> <tr><td>hc.zoning.code</td><td>string</td><td>The zoning code of the property</td><td>R-1</td> <td></td></tr> <tr><td>hc.zoning.description</td><td>string</td><td>Description of zoning</td><td>This property is zoned as R-1, which designates it for single-family residential use</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 Parcel Number</td><td>9876-54-0-00-789</td> <td></td></tr> <tr><td>assessment.amount_annual</td><td>number</td><td>Annual assessment amount</td><td>6800.75</td> <td></td></tr> <tr><td>assessment.value_assessed</td><td>integer</td><td>Assessed value of the property</td><td>350000</td> <td></td></tr> <tr><td>assessment.value_assessed_improvement</td><td>integer</td><td>Assessed value of improvements</td><td>200000</td> <td></td></tr> <tr><td>assessment.value_assessed_land</td><td>integer</td><td>Assessed value of land</td><td>150000</td> <td></td></tr> <tr><td>assessment.tax_year</td><td>integer</td><td>Tax year for assessment</td><td>2023</td> <td></td></tr> <tr><td>assessment.year_assessed</td><td>integer</td><td>Year of assessment</td><td>2022</td> <td></td></tr> <tr><td>errors</td><td>array</td><td></td><td></td> <td></td></tr> <tr><td>errors[]</td><td>string</td><td></td><td></td> <td></td></tr> </table>Query parameters
Unique readable string identifier for the property
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)
Unit number for the property, if needed and not already specified in the address string
City in which the property is located
2-letter acronym of the US state in which the property is located
5-digit US zipcode in which the property is located
Specify which results are returned updated
Response
Success
Example response
{
"subject_address": {
"address_full": "123 Main St San Francisco CA 94132",
"slug": "123-Main-St-Apt-1B-San-Francisco-CA-94132",
"block_id": "060750313013007",
"city": "San Francisco",
"fips": "06075",
"geo_precision": "rooftop",
"latitude": 37.789,
"longitude": -122.401,
"state": "CA",
"unit": "Apt 1B",
"address": "123 Main St",
"zipcode": "94132",
"zipcode_plus4": "1234",
"msa": "41860"
},
"public_records": {
"architectural_style": "Colonial",
"attic": "Finished",
"basement": {
"finished_pct": 75.5,
"has": true,
"total_area": 1200
},
"bathrooms": {
"full": 2,
"partial": 1,
"total": 2.5,
"total_provided": "3",
"total_projected": 3.5
},
"bedrooms": 4,
"buildings": 1,
"building_quality": "Excellent",
"building_condition_code": "Excellent",
"construction_types": [
"Wood Frame"
],
"cooling": [
"Central Air"
],
"fireplace": "Gas",
"fireplaces_total": 1,
"heating": [
"Forced air unit"
],
"legal_description": "Lot 123, Block A, Subdivision X",
"living_area": 2400.4,
"lot_size": 10000,
"neighborhood": "Suburban",
"parcel_id": "1829264TC000011000060A",
"parking": {
"description": "Attached Garage",
"garage": 2,
"total": 4
},
"pool": true,
"property_type": "SFR",
"property_type_description": "Single Family Residential",
"roof_material": "Composition Shingle",
"roof_type": "Gable",
"rooms_total": 8,
"sewer_public": true,
"solar_panels": true,
"stories": 2,
"subdivision": true,
"units_total": 2,
"walls_exterior_material": "Stucco",
"water": "City water",
"year_built": 1995,
"zoning": {
"code": "R-1",
"description": "This property is zoned as R-1, which designates it for single-family residential use"
}
},
"hc": {
"architectural_style": "Contemporary",
"attic": "Unfinished",
"basement": {
"finished_pct": 50.2,
"total_area": 900
},
"bathrooms": {
"full": 3,
"partial": 1,
"total": 3.5,
"total_provided": "4",
"total_projected": 4.5
},
"bedrooms": 3,
"buildings": 1,
"building_quality": "Good",
"construction_types": [
"Brick"
],
"cooling": [
"Ductless Mini Split"
],
"fireplace": "Wood Burning",
"fireplaces_total": 2,
"heating": [
"Radiant Heat"
],
"legal_description": "Lot 456, Block B, Subdivision Y",
"living_area": 1800.4,
"lot_size": 7500,
"neighborhood": "Urban",
"parcel_id": "1829264TC000011000060A",
"parking": {
"description": "Attached Garage",
"garage": 2,
"total": 4
},
"pool": true,
"property_type": "Condo",
"property_type_description": "Single Family Residential",
"roof_material": "Composition Shingle",
"roof_type": "Hip",
"rooms_total": 6,
"sewer_public": true,
"solar_panels": true,
"stories": 2,
"subdivision": true,
"units_total": 2,
"walls_exterior_material": "Stucco",
"water": "City water",
"year_built": 2008,
"zoning": {
"code": "R-1",
"description": "This property is zoned as R-1, which designates it for single-family residential use"
}
},
"assessment": {
"apn": "9876-54-0-00-789",
"amount_annual": 6800.75,
"value_assessed": 350000,
"value_assessed_improvement": 200000,
"value_assessed_land": 150000,
"tax_year": 2023,
"year_assessed": 2022
}
}