---
title: "Market Quality From Address"
method: GET
path: "/v2/property/zip_market_grade"
tags: ["Zipcode Level"]
---

# Market Quality From Address

`GET /v2/property/zip_market_grade`

Obtain HouseCanary's proprietary market grade, representing the relative desirability and volatility of the ZIP code compared to others in the same market, to better assess investment opportunities at different points throughout the housing cycle. 

Source: HouseCanary 

Pricing Tier: Basic 

Updated: Annually

## Request Query Params

<table><tr><th>Property</th><th>Type</th><th>Description</th><th>Example</th></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><th>Enum Values</th></tr>
<tr><td>market_grade</td><td>string</td><td>Grade derived from a HouseCanary proprietary cluster algorithm. One of [A, B, C, D, F] with A being least volatile across market cycles and F being most volatile.</td><td>A</td>
        <td>[A, B, C, D, F]</td></tr>
</table>

## Query parameters

- `slug` string
- `address` string, required
- `unit` string
- `city` string
- `state` string
- `zipcode` string

## Response `200`

Success

- object[]
  - `property/zip_market_grade` object
    - `api_code_description` string
    - `api_code` unknown
    - `result` object, nullable
      - `market_grade` 'A' | 'B' | 'C' | 'D' | 'F' — Grade derived from a HouseCanary proprietary cluster algorithm. One of [A, B, C, D, F] with A being least volatile across market cycles and F being most volatile.
  - `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)