---
title: "Land Value (Batch)"
method: POST
path: "/v2/property/land_value"
tags: ["Property Level"]
---

# Land Value (Batch)

`POST /v2/property/land_value`

HouseCanary's automated land value estimate, assisting in land pricing and investment analysis.

HouseCanary's proprietary Automated Land Valuation Model utilizes a unique machine learning algorithm on top of multiple input data sources to estimate the current market value of the land contained on the parcel. Responses include upper and lower bounds, as well as a forecast standard deviation (FSD) for transparency into model confidence. 

Source: HouseCanary 

Pricing Tier: Premium 

Updated: Monthly

## 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>value_mean</td><td>integer</td><td>HouseCanary automated monthly land value. Created using a robust model ensemble methodology</td><td>150000</td>
        </tr>
<tr><td>value_upr</td><td>integer</td><td>HouseCanary land AVM upper bound. Calculated as value_mean * (1 + fsd)</td><td>165000</td>
        </tr>
<tr><td>value_lwr</td><td>integer</td><td>HouseCanary land AVM lower bound. Calculated as value_mean * (1 - fsd)</td><td>135000</td>
        </tr>
<tr><td>fsd</td><td>number</td><td>HouseCanary forecast standard deviation for the HouseCanary land AVM</td><td>0.1</td>
        </tr>
</table>

## 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/land_value` object
    - `api_code_description` string
    - `api_code` unknown
    - `result` object, nullable
      - `value_mean` integer — HouseCanary automated monthly land value. Created using a robust model ensemble methodology
      - `value_upr` integer — HouseCanary land AVM upper bound. Calculated as value_mean * (1 + fsd)
      - `value_lwr` integer — HouseCanary land AVM lower bound. Calculated as value_mean * (1 - fsd)
      - `fsd` number — HouseCanary forecast standard deviation for the HouseCanary land AVM
  - `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)