---
title: "Market Quality (Batch)"
method: POST
path: "/v2/zip/market_grade"
tags: ["Zipcode Level"]
---

# Market Quality (Batch)

`POST /v2/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 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>[].zipcode</td><td>string</td><td>5-digit zipcode</td><td>33019</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>

## Request body

- object[]
  - `zipcode` string, required — 5-digit zipcode

## Response `200`

Success

- object[]
  - `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.
  - `zipcode_info` ZipcodeInfo
    - `zip` string, nullable — 5-digit zip code

## 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)