Property Level
Property Details Advanced (Batch)
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 Body Fields
<table><tr><th>Field</th><th>Type</th><th>Description</th><th>Example</th></tr> <tr><td>[]</td><td>object</td><td></td><td></td> </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>[]</td><td>object</td><td></td><td></td> <td></td></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>post/v3/property/details_advanced
Request body
Example request
[
{
"slug": "123-Main-St-Apt-1B-San-Francisco-CA-94132",
"address": "123 Main St",
"unit": "Apt 1B",
"city": "San Francisco",
"state": "CA",
"zipcode": "94105"
}
]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
}
}
]