Property Level

Value with Adjustments (Batch)

Estimate adjusted property values based on potential modifications, useful for evaluating renovation opportunities and ROI. At least one of the following parameters is required to adjust value: addition of bedrooms, bathrooms, square footage, or pool.

If multiple details are specified in one request, the adjusted_value_to in the response will reflect the combined effect of all adjustments - it will not return separate values for each individual adjustment. To determine the value effects of several different adjustments, multiple queries are required, but can be combined into one POST request.

If we cannot perform the adjustment for any reason, a 204 response will be returned and the call will not be charged.

Source: HouseCanary

Pricing Tier: Basic

Updated: Monthly

Request Query Params

<table><tr><th>Property</th><th>Type</th><th>Description</th><th>Example</th></tr> <tr><td>add_beds</td><td>integer</td><td>The number of bedrooms to add to calculate an adjusted value for the property.</td><td>2</td> </tr> <tr><td>add_baths</td><td>number</td><td>The number of bathrooms to add to calculate an adjusted value for the property. Only accepts whole and half number values, corresponding to full and half bathrooms.</td><td>1</td> </tr> <tr><td>add_sqft</td><td>integer</td><td>The number of square feet to add to calculate an adjusted value for the property.</td><td>400</td> </tr> <tr><td>add_pools</td><td>integer</td><td>The number of pools to add to calculate an adjusted value for the property. Only accepts a value of "1".</td><td>1</td> </tr> </table>

Request Body Fields

<table><tr><th>Field</th><th>Type</th><th>Description</th><th>Example</th></tr> <tr><td>[]</td><td>object</td><td></td><td></td> </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></tr> <tr><td>adjusted_value_to</td><td>integer</td><td>The adjusted value of the property based on the provided adjustments.</td><td>350000</td> </tr> <tr><td>adjustments</td><td>object</td><td></td><td></td> </tr> <tr><td>adjustments.add_beds</td><td>integer</td><td>The number of bedrooms added to calculate the adjusted value.</td><td>2</td> </tr> <tr><td>adjustments.add_baths</td><td>number</td><td>The number of bathrooms added to calculate the adjusted value.</td><td>1.5</td> </tr> <tr><td>adjustments.add_sqft</td><td>integer</td><td>The number of square feet added to calculate the adjusted value.</td><td>400</td> </tr> <tr><td>adjustments.add_pools</td><td>integer</td><td>The number of pools added to calculate the adjusted value.</td><td>1</td> </tr> </table>
post/v2/property/value_details_adjusted

Query parameters

add_bedsinteger

The number of bedrooms to add to calculate an adjusted value for the property.

add_bathsnumber

The number of bathrooms to add to calculate an adjusted value for the property. Only accepts whole and half number values, corresponding to full and half bathrooms.

add_sqftinteger

The number of square feet to add to calculate an adjusted value for the property.

add_poolsinteger

The number of pools to add to calculate an adjusted value for the property. Only accepts a value of "1".

Request body

slugstring

Unique readable string identifier for the property

addressstring required

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)

unitstring

Unit number for the property, if needed and not already specified in the address string

citystring

City in which the property is located

statestring

2-letter acronym of the US state in which the property is located

zipcodestring

5-digit US zipcode in which the property is located

Example request

[
  {
    "slug": "123-Main-St-Apt-1B-San-Francisco-CA-94132",
    "address": "123 Main St",
    "unit": "Apt 1B",
    "city": "San Francisco",
    "state": "CA",
    "zipcode": "94105"
  }
]

Response

Success

Example response

[
  {
    "property/value_details_adjusted": {
      "result": {
        "adjusted_value_to": 350000,
        "adjustments": {
          "add_beds": 2,
          "add_baths": 1.5,
          "add_sqft": 400,
          "add_pools": 1
        }
      }
    },
    "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"
        ]
      }
    }
  }
]