Value by Condition

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>

[
  {
    "property/value_by_six_conditions": {
      "result": {
        "value": {
          "price_mean": 450000,
          "price_upr": 480000,
          "price_lwr": 420000,
          "fsd": 0.1,
          "price_at_cond_0": 380000,
          "price_at_cond_1": 410000,
          "price_at_cond_2": 430000,
          "price_at_cond_3": 440000,
          "price_at_cond_4": 460000,
          "price_at_cond_5": 490000,
          "condition_class": "C4"
        }
      }
    },
    "address_info": {
      "address_full": "123 Main St San Francisco CA 94132",
      "slug": "123-Main-St-Apt-1B-San-Francisco-CA-94132",
      "address": "123 Main St",
      "unit": "Apt 1B",
      "city": "San Francisco",
      "state": "CA",
      "zipcode": "94132",
      "zipcode_plus4": "1234",
      "block_id": "060750313013007",
      "blockgroup_id": "060750201004",
      "county_fips": "06075",
      "metrodiv": "41860",
      "msa": "41860",
      "geo_precision": "rooftop",
      "lat": 37.789,
      "lng": -122.401,
      "status": {
        "match": true,
        "details": [
          "Address fully verified"
        ],
        "requested_item": {
          "zipcode": "94132",
          "address": "123+Main+St"
        },
        "changes": [
          "State added or changed"
        ]
      }
    }
  }
]