---
title: "Value with Adjustments (Batch)"
method: POST
path: "/v2/property/value_details_adjusted"
tags: ["Property Level"]
---

# Value with Adjustments (Batch)

`POST /v2/property/value_details_adjusted`

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>

## Query parameters

- `add_beds` integer
- `add_baths` number
- `add_sqft` integer
- `add_pools` integer

## Request body

- object[]
  - `slug` string — Unique readable string identifier for the property
  - `address` string, 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)
  - `unit` string — Unit number for the property, if needed and not already specified in the address string
  - `city` string — City in which the property is located
  - `state` string — 2-letter acronym of the US state in which the property is located
  - `zipcode` string — 5-digit US zipcode in which the property is located

## Response `200`

Success

- object[]
  - `property/value_details_adjusted` object
    - `api_code_description` string
    - `api_code` unknown
    - `result` object, nullable
      - `adjusted_value_to` integer — The adjusted value of the property based on the provided adjustments.
      - `adjustments` object
        - `add_beds` integer — The number of bedrooms added to calculate the adjusted value.
        - `add_baths` number — The number of bathrooms added to calculate the adjusted value.
        - `add_sqft` integer — The number of square feet added to calculate the adjusted value.
        - `add_pools` integer — The number of pools added to calculate the adjusted value.
  - `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)