Historical Value (Batch)

HouseCanary's flagship historical automated property value estimate.

HouseCanary's proprietary Automated Valuation Model (AVM) utilizes a unique machine learning algorithm on top of multiple input data sources to estimate the current market value of a residential property. Responses include upper and lower bounds, as well as a forecast standard deviation (FSD) for transparency into model confidence.

Pricing Tier: Premium

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>[].subject</td><td>object</td><td></td><td></td> </tr> <tr><td>[].subject.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>[].subject.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>[].subject.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>[].subject.city</td><td>string</td><td>City in which the property is located</td><td>San Francisco</td> </tr> <tr><td>[].subject.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>[].subject.zipcode</td><td>string</td><td>5-digit US zipcode in which the property is located</td><td>94105</td> </tr> <tr><td>[].date</td><td>string</td><td>Date (YYYY-MM-DD) or UTC timestamp of historical value</td><td>"2021-06-01" or "2022-03-01T12:34:56Z"</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>Object containing estimated historical AVM data for the subject property</td><td></td> <td></td></tr> <tr><td>[].historical_value</td><td>object</td><td></td><td></td> <td></td></tr> <tr><td>[].historical_value.price_mean</td><td>integer</td><td>HouseCanary automated monthly home value. Created using a robust model ensemble methodology.</td><td>325000</td> <td></td></tr> <tr><td>[].historical_value.price_upr</td><td>integer</td><td>HouseCanary AVM upper bound. Calculated as price_mean * (1 + fsd)</td><td>340000</td> <td></td></tr> <tr><td>[].historical_value.price_lwr</td><td>integer</td><td>HouseCanary AVM lower bound. Calculated as price_mean * (1 - fsd)</td><td>310000</td> <td></td></tr> <tr><td>[].historical_value.fsd</td><td>integer</td><td>HouseCanary forecast standard deviation for the HouseCanary AVM</td><td>0.05</td> <td></td></tr> <tr><td>[].historical_value.date</td><td>string</td><td>Date (YYYY-MM-DD) or UTC timestamp of historical value</td><td>"2021-06-01"</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>

[
  {
    "subject": {
      "slug": "123-Main-St-Apt-1B-San-Francisco-CA-94132",
      "address": "123 Main St",
      "unit": "Apt 1B",
      "city": "San Francisco",
      "state": "CA",
      "zipcode": "94105"
    },
    "date": "\"2021-06-01\" or \"2022-03-01T12:34:56Z\""
  }
]

[
  {
    "historical_value": {
      "price_mean": 325000,
      "price_upr": 340000,
      "price_lwr": 310000,
      "date": "\"2021-06-01\""
    },
    "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"
    }
  }
]