{"uid":"cap_N7siE4uzvuZiZz-PY9Xfe","slug":"hcad-neighborhood-protest-outcome-statistics-f6acf67f","name":"HCAD Neighborhood Protest Outcome Statistics","description":"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.","url":"https://hcad-api.canvas-cart.workers.dev/area/:neighborhood/protest-stats","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oDpVrzvCQ_-aGlVhvt04D","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns aggregated ARB protest outcome statistics (hearing count, value reduction rate, median reduction) for a Harris County Appraisal District neighborhood code by tax year.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Evaluating protest worthiness before filing","prompt":"Before I protest my Harris County property tax appraisal, can you pull the protest outcome stats for HCAD neighborhood code 2200 so I can see how often people actually win hearings there and what the typical reduction is?"},{"title":"Real estate market research by neighborhood","prompt":"I'm researching investment properties in Harris County. Can you get me the ARB protest statistics for neighborhood code 1050 — I want to know how many hearings there were and what percentage resulted in a value drop?"},{"title":"Comparing protest success rates across years","prompt":"Can you show me the year-by-year protest hearing stats for HCAD neighborhood 3300 — I want to see if the success rate or median reduction has changed over recent tax years?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:42:45.601Z","isFirstParty":false}