---
title: "Value Analysis"
method: GET
path: "/v2/property/value_analysis"
tags: ["Property Level"]
---

# Value Analysis

`GET /v2/property/value_analysis`

Value Analysis provides a set of automated checks to test the feasibility of a property value based on HouseCanary’s data and models. It provides a recommended approach for coming to a high-confidence value for the property. 

Source: HouseCanary 

Pricing Tier: Premium 

Updated: Monthly

## Request Query Params

<table><tr><th>Property</th><th>Type</th><th>Description</th><th>Example</th></tr>
<tr><td>slug</td><td>string</td><td>A single URL-safe string identifying the address (obtained from HouseCanary)</td><td>1624-E-Dogwood-Ln-Gilbert-AZ-85295</td>
        </tr>
<tr><td>street_address</td><td>string</td><td>Building number, street name and unit number</td><td>123 Main St San Francisco CA 94132</td>
        </tr>
<tr><td>zipcode</td><td>integer</td><td>5-digit ZIP code</td><td>94132</td>
        </tr>
<tr><td>estimated_value</td><td>integer</td><td>Outside estimate of the property’s value, maybe from a BPO or previous appraised value</td><td>325000</td>
        </tr>
<tr><td>gla_sqft</td><td>integer</td><td>Gross living area of property in square feet</td><td>2750</td>
        </tr>
<tr><td>include_comp_based_analysis</td><td>boolean</td><td>Whether to include comp-based analysis (response may be slower if included)</td><td>true</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>checks</td><td>object</td><td>Preliminary data checks to determine whether HouseCanary can provide an AVM for the property in question</td><td></td>
        <td></td></tr>
<tr><td>checks.All pre-analysis checks passed</td><td>boolean</td><td><code>true</code> if all the other checks are <code>true</code>, <code>false</code> otherwise</td><td>true</td>
        <td></td></tr>
<tr><td>checks.Address is supported</td><td>boolean</td><td><code>true</code> if the provided address can be parsed, <code>false</code> otherwise</td><td>true</td>
        <td></td></tr>
<tr><td>checks.Address is complete</td><td>boolean</td><td><code>true</code> if the provided address includes all necessary detail to resolve to a specific residence, <code>false</code> otherwise (most commonly a <code>false</code> value indicates a missing unit number for a multi-unit property address)</td><td>true</td>
        <td></td></tr>
<tr><td>checks.Precise geocode is available for address</td><td>boolean</td><td><code>true</code> if HouseCanary has a rooftop accurate geocode for the address, <code>false</code> otherwise</td><td>true</td>
        <td></td></tr>
<tr><td>checks.Property at address is of supported type</td><td>boolean</td><td>Returns <code>true</code> if the property at the specified address is of a supported type; <code>false</code> otherwise.</td><td>true</td>
        <td></td></tr>
<tr><td>checks.Census block group information is available</td><td>boolean</td><td><code>true</code> if HouseCanary has blockgroup value distribution data for the blockgroup containing the property,<code>false</code> otherwise</td><td>true</td>
        <td></td></tr>
<tr><td>checks.Enough information on neighborhood characteristics is available</td><td>boolean</td><td>True if HouseCanary has value per square foot data for at least 70% of properties in the blockgroup, False otherwise</td><td>true</td>
        <td></td></tr>
<tr><td>checks.Gross living area of property is available or provided as input</td><td>boolean</td><td>True if HouseCanary has data for the gross living area of the property or it was provided in the request as the gla_sqft value, False otherwise</td><td>true</td>
        <td></td></tr>
<tr><td>checks.Comps available for analysis</td><td>boolean</td><td>True if at least 5 highly similar comparable properties exist, False otherwise</td><td>true</td>
        <td></td></tr>
<tr><td>input_params</td><td>object</td><td></td><td></td>
        <td></td></tr>
<tr><td>input_params.slug</td><td>string</td><td>A single URL-safe string identifying the address (obtained from HouseCanary)</td><td>1624-E-Dogwood-Ln-Gilbert-AZ-85295</td>
        <td></td></tr>
<tr><td>input_params.product_type</td><td>string</td><td>The product type</td><td>value_analysis</td>
        <td></td></tr>
<tr><td>input_params.include_comp_based_analysis</td><td>string</td><td>Whether to include comp-based analysis was included in the request</td><td>true</td>
        <td>[true, false]</td></tr>
<tr><td>input_params.zipcode</td><td>string</td><td>The zipcode</td><td>85020</td>
        <td></td></tr>
<tr><td>input_params.street_address</td><td>string</td><td>Building number, street name and unit number</td><td>123 Main St</td>
        <td></td></tr>
<tr><td>input_params.estimated_value</td><td>string</td><td>Outside estimate of the property’s value, maybe from a BPO or previous appraised value</td><td>320000</td>
        <td></td></tr>
<tr><td>input_params.gla_sqft</td><td>string</td><td>Gross living area of property in square feet</td><td>2750</td>
        <td></td></tr>
<tr><td>recommended_approach</td><td>string</td><td>HouseCanary’s suggested course of action to determine the value of the property with high confidence. One of: <pre>[No exceptions - Automate, Minor exceptions - Human review, Major exceptions - Onsite review]</pre></td><td>Minor exceptions - Human review</td>
        <td></td></tr>
<tr><td>hc_avm_value_analysis</td><td>object</td><td>How HouseCanary’s AVM for the property relates to the area</td><td></td>
        <td></td></tr>
<tr><td>hc_avm_value_analysis.avm_value</td><td>integer</td><td>HouseCanary automated value model for the property</td><td>1801218</td>
        <td></td></tr>
<tr><td>hc_avm_value_analysis.avm_confidence</td><td>string</td><td>Confidence of the HouseCanary AVM for the property</td><td>high</td>
        <td>[low, medium, high]</td></tr>
<tr><td>hc_avm_value_analysis.avm_fsd</td><td>number</td><td>Forecast standard deviation (FSD) for the AVM value, representing the model’s confidence. Lower values indicate higher confidence in the AVM estimate.</td><td>0.1414001</td>
        <td></td></tr>
<tr><td>hc_avm_value_analysis.neighborhood_analysis</td><td>object</td><td>Details about housing stock in the census blockgroup containing the property</td><td></td>
        <td></td></tr>
<tr><td>hc_avm_value_analysis.neighborhood_analysis.avm_value_sqft</td><td>integer</td><td>Value per square foot</td><td>987</td>
        <td></td></tr>
<tr><td>hc_avm_value_analysis.neighborhood_analysis.5th_percentile_value_per_sqft</td><td>number</td><td>5th percentile of the range of property values in the area (i.e. low end of value range)</td><td>578.1</td>
        <td></td></tr>
<tr><td>hc_avm_value_analysis.neighborhood_analysis.95th_percentile_value_per_sqft</td><td>number</td><td>95th percentile of the range of property values in the area (i.e. high end of value range)</td><td>988.7</td>
        <td></td></tr>
<tr><td>hc_avm_value_analysis.neighborhood_analysis.within_neighborhood_norms</td><td>boolean</td><td><code>true</code> if the value falls between the 5th and 95th percentile of neighborhood values, <code>false</code> otherwise</td><td>true</td>
        <td></td></tr>
<tr><td>hc_avm_value_analysis.comp_based_analysis</td><td>object</td><td>Feasibility of the property value based on comparable properties (adjusted by GLA)</td><td></td>
        <td></td></tr>
<tr><td>hc_avm_value_analysis.comp_based_analysis.comp_fsd</td><td>number</td><td>Forecast standard deviation (FSD) for the comparable-based valuation, indicating the model’s confidence. Lower values suggest higher confidence in the comp-based estimate.</td><td>0.131</td>
        <td></td></tr>
<tr><td>hc_avm_value_analysis.comp_based_analysis.number_of_comps</td><td>integer</td><td>Number of high similarity comparable properties included in the analysis</td><td>15</td>
        <td></td></tr>
<tr><td>hc_avm_value_analysis.comp_based_analysis.5th_percentile_adjusted_comp_value</td><td>integer</td><td>5th percentile of the range of property values for adjusted comparable properties (i.e. low end of value range)</td><td>1134796</td>
        <td></td></tr>
<tr><td>hc_avm_value_analysis.comp_based_analysis.95th_percentile_adjusted_comp_value</td><td>integer</td><td>95th percentile of the range of property values for adjusted comparable properties (i.e. high end of value range)</td><td>1734155</td>
        <td></td></tr>
<tr><td>hc_avm_value_analysis.comp_based_analysis.avm_value_percentile_in_adjusted_comp_values</td><td>number</td><td>Where the percentile ranking of the value lies in the distribution of adjusted comp prices</td><td>96.5</td>
        <td></td></tr>
<tr><td>hc_avm_value_analysis.comp_based_analysis.within_adjusted_comp_values</td><td>boolean</td><td><code>true</code> if the value falls between the 5th and 95th percentile of adjusted comp values, <code>false</code> otherwise</td><td>true</td>
        <td></td></tr>
</table>

## Query parameters

- `slug` string
- `street_address` string
- `zipcode` integer
- `estimated_value` integer
- `gla_sqft` integer
- `include_comp_based_analysis` boolean

## Response `200`

Success

- object
  - `checks` object, required — Preliminary data checks to determine whether HouseCanary can provide an AVM for the property in question
    - `All pre-analysis checks passed` boolean — <code>true</code> if all the other checks are <code>true</code>, <code>false</code> otherwise
    - `Address is supported` boolean — <code>true</code> if the provided address can be parsed, <code>false</code> otherwise
    - `Address is complete` boolean — <code>true</code> if the provided address includes all necessary detail to resolve to a specific residence, <code>false</code> otherwise (most commonly a <code>false</code> value indicates a missing unit number for a multi-unit property address)
    - `Precise geocode is available for address` boolean — <code>true</code> if HouseCanary has a rooftop accurate geocode for the address, <code>false</code> otherwise
    - `Property at address is of supported type` boolean — Returns <code>true</code> if the property at the specified address is of a supported type; <code>false</code> otherwise.
    - `Census block group information is available` boolean — <code>true</code> if HouseCanary has blockgroup value distribution data for the blockgroup containing the property,<code>false</code> otherwise
    - `Enough information on neighborhood characteristics is available` boolean — True if HouseCanary has value per square foot data for at least 70% of properties in the blockgroup, False otherwise
    - `Gross living area of property is available or provided as input` boolean — True if HouseCanary has data for the gross living area of the property or it was provided in the request as the gla_sqft value, False otherwise
    - `Comps available for analysis` boolean — True if at least 5 highly similar comparable properties exist, False otherwise
  - `input_params` object, required
    - `slug` string — A single URL-safe string identifying the address (obtained from HouseCanary)
    - `product_type` string — The product type
    - `include_comp_based_analysis` 'true' | 'false' — Whether to include comp-based analysis was included in the request
    - `zipcode` string — The zipcode
    - `street_address` string — Building number, street name and unit number
    - `estimated_value` string — Outside estimate of the property’s value, maybe from a BPO or previous appraised value
    - `gla_sqft` string — Gross living area of property in square feet
  - `recommended_approach` string, required — HouseCanary’s suggested course of action to determine the value of the property with high confidence. One of: <pre>[No exceptions - Automate, Minor exceptions - Human review, Major exceptions - Onsite review]</pre>
  - `hc_avm_value_analysis` object, required — How HouseCanary’s AVM for the property relates to the area
    - `avm_value` integer — HouseCanary automated value model for the property
    - `avm_confidence` 'low' | 'medium' | 'high' — Confidence of the HouseCanary AVM for the property
    - `avm_fsd` number, float — Forecast standard deviation (FSD) for the AVM value, representing the model’s confidence. Lower values indicate higher confidence in the AVM estimate.
    - `neighborhood_analysis` object — Details about housing stock in the census blockgroup containing the property
      - `avm_value_sqft` integer — Value per square foot
      - `5th_percentile_value_per_sqft` number — 5th percentile of the range of property values in the area (i.e. low end of value range)
      - `95th_percentile_value_per_sqft` number, float — 95th percentile of the range of property values in the area (i.e. high end of value range)
      - `within_neighborhood_norms` boolean — <code>true</code> if the value falls between the 5th and 95th percentile of neighborhood values, <code>false</code> otherwise
    - `comp_based_analysis` object — Feasibility of the property value based on comparable properties (adjusted by GLA)
      - `comp_fsd` number, float — Forecast standard deviation (FSD) for the comparable-based valuation, indicating the model’s confidence. Lower values suggest higher confidence in the comp-based estimate.
      - `number_of_comps` integer — Number of high similarity comparable properties included in the analysis
      - `5th_percentile_adjusted_comp_value` integer — 5th percentile of the range of property values for adjusted comparable properties (i.e. low end of value range)
      - `95th_percentile_adjusted_comp_value` integer — 95th percentile of the range of property values for adjusted comparable properties (i.e. high end of value range)
      - `avm_value_percentile_in_adjusted_comp_values` number, float — Where the percentile ranking of the value lies in the distribution of adjusted comp prices
      - `within_adjusted_comp_values` boolean — <code>true</code> if the value falls between the 5th and 95th percentile of adjusted comp values, <code>false</code> otherwise

## 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)