Property Level

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>
get/v3/property/details_advanced

Query parameters

slugstring

Unique readable string identifier for the property

addressstring required

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)

unitstring

Unit number for the property, if needed and not already specified in the address string

citystring

City in which the property is located

statestring

2-letter acronym of the US state in which the property is located

zipcodestring

5-digit US zipcode in which the property is located

type'hc' | 'public' | 'both' nullable

Specify which results are returned updated

Response

Success

errorsstring[]

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
  }
}