Property Level

Estimated property value (Batch)

Our Property Value Estimation API gives a rough idea of a property's current worth within a set range of accuracy. It uses a reliable Automated Valuation Model and a special rounding method to ensure fairness and security. This method balances speed and accuracy, providing useful estimates for different property types while aiming to be as unbiased as possible

Source: HouseCanary

Pricing Tier: Refer to Pricing Page

Updated: 15 minutes

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>[].estimate</td><td>integer</td><td>Estimated value</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>[].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/estimate

Request body

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

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

estimateinteger nullable

Estimated value

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