---
title: "Value Historical From Address"
method: GET
path: "/v2/property/blockgroup_value_ts_historical"
tags: ["Census Block Group Level"]
---

# Value Historical From Address

`GET /v2/property/blockgroup_value_ts_historical`

Retrieve historical time series data for monthly blockgroup-median property values and dollar values per sq ft, offering valuable insights into past market trends and performance. Historical data available back to 1985 or after depending on local market data availability. 

Source: HouseCanary 

Pricing Tier: Premium 

Updated: Monthly

## 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>property_type</td><td>string</td><td>Desired property type to include in the time series. Defaults to SFD. One of [SFD, TH, CND, INC, MFH].</td><td></td>
        <td>[SFD, TH, CND, INC, MFH]</td></tr>
<tr><td>order</td><td>string</td><td>Chronological order to sort result items. One of [asc or desc]. Defaults to asc.</td><td></td>
        <td>[asc, desc]</td></tr>
<tr><td>limit</td><td>integer</td><td>Maximum integer number of result items to return. Defaults to null.</td><td>10</td>
        <td></td></tr>
<tr><td>start</td><td>string</td><td>Beginning date limit for result items, based on month, in ISO 8601 format, i.e. 2015-01-01. Defaults to null.</td><td>2015-01-01</td>
        <td></td></tr>
<tr><td>end</td><td>string</td><td>Ending date limit for result items, based on month, in ISO 8601 format, i.e. 2015-01-01. Defaults to null.</td><td>2015-01-01</td>
        <td></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>property_type</td><td>string</td><td>Type of property specified in the request. Defaults to SFD. One of ["SFD", "TH", "CND", "INC", "MFH"].</td><td>TH</td>
        <td>[SFD, TH, CND, INC, MFH]</td></tr>
<tr><td>time_series</td><td>array</td><td>List of months and values.</td><td></td>
        <td></td></tr>
<tr><td>time_series[]</td><td>object</td><td></td><td></td>
        <td></td></tr>
<tr><td>time_series[].month</td><td>string</td><td>Month of the value in ISO format.</td><td>2023-08-01</td>
        <td></td></tr>
<tr><td>time_series[].value_median</td><td>integer</td><td>Amount in dollars of the forecasted median property sale value for the month.</td><td>320000</td>
        <td></td></tr>
<tr><td>time_series[].value_sqft_median</td><td>number</td><td>Amount in dollars of the forecasted median property sale value per square foot for the month.</td><td>210.5</td>
        <td></td></tr>
</table>

## Query parameters

- `slug` string
- `address` string, required
- `unit` string
- `city` string
- `state` string
- `zipcode` string
- `property_type` 'SFD' | 'TH' | 'CND' | 'INC' | 'MFH'
- `order` 'asc' | 'desc'
- `limit` integer
- `start` string, date
- `end` string, date

## Response `200`

Success

- object[]
  - `property/blockgroup_value_ts_historical` object
    - `api_code_description` string
    - `api_code` unknown
    - `result` object, nullable
      - `property_type` 'SFD' | 'TH' | 'CND' | 'INC' | 'MFH' — Type of property specified in the request. Defaults to SFD. One of ["SFD", "TH", "CND", "INC", "MFH"].
      - `time_series` object[] — List of months and values.
        - `month` string — Month of the value in ISO format.
        - `value_median` integer — Amount in dollars of the forecasted median property sale value for the month.
        - `value_sqft_median` number — Amount in dollars of the forecasted median property sale value per square foot for the month.
  - `address_info` AddressInfo
    - `address_full` string, nullable — Full address string
    - `slug` string, nullable — HouseCanary address slug
    - `address` string, nullable — Street address
    - `unit` string, nullable — Unit within the building, if any
    - `city` string, nullable — City where property is located
    - `state` string, nullable — 2-character state abbreviation
    - `zipcode` string, nullable — 5-character US zipcode
    - `zipcode_plus4` string, nullable — 4-character zipcode extension
    - `block_id` string, nullable — 15-digit US census block ID
    - `blockgroup_id` string, nullable — 12-digit census block group ID
    - `county_fips` string, nullable — 5-digit US census county ID
    - `metrodiv` string, nullable — 5-digit US census Metropolitan Division ID
    - `msa` string, nullable — 5-digit US census MSA ID
    - `geo_precision` 'rooftop' | 'parcel' | 'zip9' | 'zip5' | 'unknown', nullable — A string describing available geo precision
    - `lat` number, nullable — Latitude value, in degrees
    - `lng` number, nullable — Longitude value, in degrees
    - `status` object
      - `match` boolean — Whether the address was matched to a canonical address in HouseCanary's systems
      - `details` string[]
      - `requested_item` object — Exact address parameters provided in the original API request
      - `changes` string[]
      - `errors` string[]

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/housecanary/apis/housecanary-analytics-and-portfolio-monitoring-apis.md) · [All operations](https://skmtc.net/housecanary/apis/housecanary-analytics-and-portfolio-monitoring-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/housecanary/housecanary-analytics-and-portfolio-monitoring-apis/revisions/38afb6724de7/schema)