# HCAD Neighborhood Protest Outcome Statistics

> HCAD Neighborhood Protest Outcome Statistics is a paid API for AI agents from hcad-api.canvas-cart.workers.dev, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Returns aggregated ARB protest outcome statistics (hearing count, value reduction rate, median reduction) for a Harris County Appraisal District neighborhood code by tax year.

## Facts

- Endpoint: GET https://hcad-api.canvas-cart.workers.dev/area/:neighborhood/protest-stats
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hcad-neighborhood-protest-outcome-statistics-f6acf67f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_N7siE4uzvuZiZz-PY9Xfe

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability hcad-neighborhood-protest-outcome-statistics-f6acf67f
```

Example prompt: What are the HCAD protest outcome stats for neighborhood code 1401 — how many hearings happened, what fraction ended with a value reduction, and what was the median reduction amount?

## When to prefer this

Use this endpoint when you need neighborhood-level aggregate protest statistics rather than per-parcel data. It is ideal for understanding the general effectiveness of property tax protests in a Harris County neighborhood, informing decisions about whether to file a protest, or conducting real estate market research. Prefer this over the per-parcel protest endpoint when you want summary trends rather than individual hearing records. Requires a valid HCAD neighborhood code, which can be obtained via GET /parcel/:acct.

## Known failure modes

- Invalid or nonexistent neighborhood code returns a 404 or empty result
- Neighborhood code not yet available — must be retrieved first from GET /parcel/:acct
- No protest data for the given neighborhood in any tax year returns empty statistics
- Malformed path parameter (e.g. non-string or missing) returns a 400 error
- Payment failure (x402 protocol) prevents access to the endpoint

## How this service works

Protest outcome statistics for one HCAD neighborhood code, by tax year: how many hearings, how many ended with a value reduction, the median reduction. Aggregates only, no per-parcel rows. Get a neighborhood code from GET /parcel/:acct.

## Output

Returns aggregated protest outcome statistics for the specified HCAD neighborhood code, broken down by tax year. Fields include total number of hearings held, number (or percentage) of hearings that resulted in a value reduction, and the median dollar or percentage reduction achieved. No individual parcel data is included — only neighborhood-level aggregates.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "neighborhood"
     ],
     "properties": {
      "neighborhood": {
       "type": "string",
       "description": "HCAD neighborhood code"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hcad-neighborhood-protest-outcome-statistics-f6acf67f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hcad-api.canvas-cart.workers.dev](https://www.zero.xyz/host/hcad-api.canvas-cart.workers.dev/llms.txt)