---
title: "Geographic attributes of property (Batch)"
method: POST
path: "/v2/property/geo_features"
tags: ["Property Level"]
---

# Geographic attributes of property (Batch)

`POST /v2/property/geo_features`

This endpoint provides geographic attributes of the property, including backyard exposure angle, backyard slope, backyard view angle, elevation, frontage length, orientation, privacy score by blockgroup and county, and view angle.  

Pricing Tier: Basic 

## 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>backyard_exposure_angle</td><td>integer</td><td>Measurement of how easily neighbors can see into the property and backyard, thus potentially mitigating privacy. Value is the angle (in degrees) exposed to backyard neighbors. Values range from 0 to 180.</td><td>120</td>
        </tr>
<tr><td>backyard_slope</td><td>integer</td><td>The slope (in degrees) along the centerline of the backyard view angle. Values range from -90 to 90. Negative values indicate downhill views, 0 is horizontal, and positive values indicate uphill views.</td><td>-10</td>
        </tr>
<tr><td>backyard_view_angle</td><td>integer</td><td>Measurement of maximum angle (in degrees) that opens up to scenery or nature from the backyard. Values range from 0 to 180.</td><td>150</td>
        </tr>
<tr><td>elevation</td><td>integer</td><td>The height (in meters) of a property in relation to sea level.</td><td>200</td>
        </tr>
<tr><td>frontage_length</td><td>integer</td><td>The length (in feet) of the parcel frontage.</td><td>75</td>
        </tr>
<tr><td>orientation</td><td>integer</td><td>Direction (in degrees) that the front of the house faces.</td><td>180</td>
        </tr>
<tr><td>privacy_score_blockgroup</td><td>integer</td><td>HouseCanary proprietary summary of the geographic attributes of a parcel relative to other parcels in the census blockgroup. Values range from 0 to 100. Higher values indicate greater privacy.</td><td>85</td>
        </tr>
<tr><td>privacy_score_county</td><td>integer</td><td>HouseCanary proprietary summary of the geographic attributes of a parcel relative to other parcels in the county. Values range from 0 to 100. Higher values indicate greater privacy.</td><td>75</td>
        </tr>
<tr><td>view_angle</td><td>integer</td><td>Maximum angle (in degrees) that one can view the surrounding area by standing at the center of a parcel. Values range from 0 to 360.</td><td>270</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/geo_features` object
    - `api_code_description` string
    - `api_code` unknown
    - `result` object, nullable
      - `backyard_exposure_angle` integer — Measurement of how easily neighbors can see into the property and backyard, thus potentially mitigating privacy. Value is the angle (in degrees) exposed to backyard neighbors. Values range from 0 to 180.
      - `backyard_slope` integer — The slope (in degrees) along the centerline of the backyard view angle. Values range from -90 to 90. Negative values indicate downhill views, 0 is horizontal, and positive values indicate uphill views.
      - `backyard_view_angle` integer — Measurement of maximum angle (in degrees) that opens up to scenery or nature from the backyard. Values range from 0 to 180.
      - `elevation` integer — The height (in meters) of a property in relation to sea level.
      - `frontage_length` integer — The length (in feet) of the parcel frontage.
      - `orientation` integer — Direction (in degrees) that the front of the house faces.
      - `privacy_score_blockgroup` integer — HouseCanary proprietary summary of the geographic attributes of a parcel relative to other parcels in the census blockgroup. Values range from 0 to 100. Higher values indicate greater privacy.
      - `privacy_score_county` integer — HouseCanary proprietary summary of the geographic attributes of a parcel relative to other parcels in the county. Values range from 0 to 100. Higher values indicate greater privacy.
      - `view_angle` integer — Maximum angle (in degrees) that one can view the surrounding area by standing at the center of a parcel. Values range from 0 to 360.
  - `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)