---
title: "Value by Condition"
method: GET
path: "/v2/property/value_by_six_conditions"
tags: ["Property Level"]
---

# Value by Condition

`GET /v2/property/value_by_six_conditions`

This endpoint allows you to determine the value of the property based on the current condition of the property as determined by HouseCanary's proprietary algorithms. Each condition class corresponds to the standardized C1 through C6 condition rating scale that conforms to <a href="https://selling-guide.fanniemae.com/sel/b4-1.3-06/property-condition-and-quality-construction-improvements#P3806">Fannie Mae UAD guidelines</a>. Values at each condition level are determined based on local market conditions and are determined through a mix of computer vision and statistical modeling. 

Source: HouseCanary 

Pricing Tier: Premium Plus 

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>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>value</td><td>object</td><td></td><td></td>
        <td></td></tr>
<tr><td>value.price_mean</td><td>integer</td><td>Same value that is provided as part of the property/value response</td><td>450000</td>
        <td></td></tr>
<tr><td>value.price_upr</td><td>integer</td><td>Same value that is provided as part of the property/value response</td><td>480000</td>
        <td></td></tr>
<tr><td>value.price_lwr</td><td>integer</td><td>Same value that is provided as part of the property/value response</td><td>420000</td>
        <td></td></tr>
<tr><td>value.fsd</td><td>number</td><td>Same value that is provided as part of the property/value response</td><td>0.1</td>
        <td></td></tr>
<tr><td>value.price_at_cond_0</td><td>integer</td><td>Quantitatively derived value of the property at the lowest condition rating of C6</td><td>380000</td>
        <td></td></tr>
<tr><td>value.price_at_cond_1</td><td>integer</td><td>Quantitatively derived value of the property at the condition rating of C5</td><td>410000</td>
        <td></td></tr>
<tr><td>value.price_at_cond_2</td><td>integer</td><td>Quantitatively derived value of the property at the condition rating of C4</td><td>430000</td>
        <td></td></tr>
<tr><td>value.price_at_cond_3</td><td>integer</td><td>Quantitatively derived value of the property at the condition rating of C3</td><td>440000</td>
        <td></td></tr>
<tr><td>value.price_at_cond_4</td><td>integer</td><td>Quantitatively derived value of the property at the condition rating of C2</td><td>460000</td>
        <td></td></tr>
<tr><td>value.price_at_cond_5</td><td>integer</td><td>Quantitatively derived value of the property at the highest condition rating of C1</td><td>490000</td>
        <td></td></tr>
<tr><td>value.condition_class</td><td>string</td><td>The current condition rating of the property as determined by HouseCanary. The standardized condition rating (C1 through C6) conforms to the UAD guidelines for determining condition.</td><td>C4</td>
        <td>[C1, C2, C3, C4, C5, C6]</td></tr>
</table>

## Query parameters

- `slug` string
- `address` string, required
- `unit` string
- `city` string
- `state` string
- `zipcode` string

## Response `200`

Success

- object[]
  - `property/value_by_six_conditions` object
    - `api_code_description` string
    - `api_code` unknown
    - `result` object, nullable
      - `value` object
        - `price_mean` integer — Same value that is provided as part of the property/value response
        - `price_upr` integer — Same value that is provided as part of the property/value response
        - `price_lwr` integer — Same value that is provided as part of the property/value response
        - `fsd` number — Same value that is provided as part of the property/value response
        - `price_at_cond_0` integer — Quantitatively derived value of the property at the lowest condition rating of C6
        - `price_at_cond_1` integer — Quantitatively derived value of the property at the condition rating of C5
        - `price_at_cond_2` integer — Quantitatively derived value of the property at the condition rating of C4
        - `price_at_cond_3` integer — Quantitatively derived value of the property at the condition rating of C3
        - `price_at_cond_4` integer — Quantitatively derived value of the property at the condition rating of C2
        - `price_at_cond_5` integer — Quantitatively derived value of the property at the highest condition rating of C1
        - `condition_class` 'C1' | 'C2' | 'C3' | 'C4' | 'C5' | 'C6' — The current condition rating of the property as determined by HouseCanary. The standardized condition rating (C1 through C6) conforms to the UAD guidelines for determining condition.
  - `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)