---
title: "Value with FSD threshold filter"
method: POST
path: "/v3/property/value_fsd_threshold"
tags: ["Property Level"]
---

# Value with FSD threshold filter

`POST /v3/property/value_fsd_threshold`

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. If the optional FSD threshold is supplied, customers are not billed for responses containing AVMs not meeting the threshold. 

Source: HouseCanary 

Pricing Tier: Premium 

Updated: Monthly

## Request Body Fields

<table><tr><th>Field</th><th>Type</th><th>Description</th><th>Example</th><th>Enum Values</th></tr>
<tr><td>fsd_threshold</td><td>number</td><td>FSD threshold for the subject avm value (optional)</td><td>0.05</td>
        <td></td></tr>
<tr><td>address_query</td><td>array</td><td>List of addresses</td><td></td>
        <td></td></tr>
<tr><td>address_query[]</td><td>object</td><td></td><td></td>
        <td></td></tr>
<tr><td>address_query[].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>address_query[].address_id</td><td>integer</td><td>HouseCanary address identifier</td><td>34343343</td>
        <td></td></tr>
<tr><td>address_query[].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>address_query[].block_id</td><td>string</td><td>15-digit US census block ID</td><td>060750313013007</td>
        <td></td></tr>
<tr><td>address_query[].city</td><td>string</td><td>City where property is located</td><td>San Francisco</td>
        <td></td></tr>
<tr><td>address_query[].fips</td><td>string</td><td>5-digit US census county ID</td><td>06075</td>
        <td></td></tr>
<tr><td>address_query[].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>address_query[].latitude</td><td>number</td><td>Latitude value, in degrees</td><td>37.789</td>
        <td></td></tr>
<tr><td>address_query[].longitude</td><td>number</td><td>Longitude value, in degrees</td><td>-122.401</td>
        <td></td></tr>
<tr><td>address_query[].state</td><td>string</td><td>2-character state abbreviation</td><td>CA</td>
        <td></td></tr>
<tr><td>address_query[].unit</td><td>string</td><td>Unit within the building, if any</td><td>Apt 1B</td>
        <td></td></tr>
<tr><td>address_query[].address</td><td>string</td><td>Street address</td><td>123 Main St</td>
        <td></td></tr>
<tr><td>address_query[].zipcode</td><td>string</td><td>5-character US zipcode</td><td>94132</td>
        <td></td></tr>
<tr><td>address_query[].zipcode_plus4</td><td>string</td><td>4-character zipcode extension</td><td>1234</td>
        <td></td></tr>
<tr><td>address_query[].msa</td><td>string</td><td>5-digit US census MSA ID</td><td>41860</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>[]</td><td>object</td><td></td><td></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>[].value</td><td>object</td><td></td><td></td>
        <td></td></tr>
<tr><td>[].value.price_upper</td><td>integer</td><td>Upper bound of the avm value</td><td>380000</td>
        <td></td></tr>
<tr><td>[].value.price_lower</td><td>integer</td><td>Lower bound of the avm value</td><td>350000</td>
        <td></td></tr>
<tr><td>[].value.price_mean</td><td>integer</td><td>Mean avm value</td><td>365000</td>
        <td></td></tr>
<tr><td>[].value.fsd</td><td>number</td><td>Fractional standard deviation of the avm value</td><td>0.5</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>

## Request body

- object
  - `fsd_threshold` number — FSD threshold for the subject avm value (optional)
  - `address_query` object[], required — List of addresses
    - `address_full` string, nullable — Full address string
    - `address_id` integer, nullable — HouseCanary address identifier
    - `slug` string, nullable — HouseCanary address slug
    - `block_id` string, nullable — 15-digit US census block ID
    - `city` string, nullable — City where property is located
    - `fips` string, nullable — 5-digit US census county ID
    - `geo_precision` 'rooftop' | 'parcel' | 'zip9' | 'zip5' | 'unknown', nullable — A string describing available geo precision
    - `latitude` number, nullable — Latitude value, in degrees
    - `longitude` number, nullable — Longitude value, in degrees
    - `state` string, nullable — 2-character state abbreviation
    - `unit` string, nullable — Unit within the building, if any
    - `address` string, nullable — Street address
    - `zipcode` string, nullable — 5-character US zipcode
    - `zipcode_plus4` string, nullable — 4-character zipcode extension
    - `msa` string, nullable — 5-digit US census MSA ID

## Response `200`

Success

- object[]
  - `subject_address` object, required
    - `address_full` string, nullable — Full address string
    - `address_id` integer, nullable — HouseCanary address identifier
    - `slug` string, nullable — HouseCanary address slug
    - `block_id` string, nullable — 15-digit US census block ID
    - `city` string, nullable — City where property is located
    - `fips` string, nullable — 5-digit US census county ID
    - `geo_precision` 'rooftop' | 'parcel' | 'zip9' | 'zip5' | 'unknown', nullable — A string describing available geo precision
    - `latitude` number, nullable — Latitude value, in degrees
    - `longitude` number, nullable — Longitude value, in degrees
    - `state` string, nullable — 2-character state abbreviation
    - `unit` string, nullable — Unit within the building, if any
    - `address` string, nullable — Street address
    - `zipcode` string, nullable — 5-character US zipcode
    - `zipcode_plus4` string, nullable — 4-character zipcode extension
    - `msa` string, nullable — 5-digit US census MSA ID
  - `value` object, required
    - `price_upper` integer, required — Upper bound of the avm value
    - `price_lower` integer, required — Lower bound of the avm value
    - `price_mean` integer, required — Mean avm value
    - `fsd` number, required — Fractional standard deviation of the avm value
  - `errors` string[], nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Address not found
- `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)