# HCAD Harris County property-tax API

Raw Harris County Appraisal District (HCAD) roll data: assessment-protest
outcomes and a per-parcel assessed-value time series. HCAD publishes this
as multi-file yearly data dumps with no per-parcel API. This service adds
one. Public record under the Texas Public Information Act. Raw delivery
only, no interpretation, no valuation opinion.

Owner names and owner mailing addresses are never served. The data is
about the property, not its owner.

## When to use this

Use this for Harris County property-tax analysis: deciding whether to
protest an assessment, researching how protests in an area usually turn
out, or pulling a clean multi-year value history for one parcel. Do not
use it for general web search or for finding who owns a property.

## Endpoints

- GET /search?addr=<street>&limit=<1-50>
  Free. Full-text match on the site address. Returns acct, address,
  class, and current assessed value for each hit. Start here to get the
  acct.

- GET /parcel/{acct}
  Free. Current-year snapshot: address, state class, land and building
  area, year improved, legal description, current assessed and market
  value.

- GET /parcel/{acct}/history
  Paid, $0.02 USDC. Every tax year on file for the parcel: land,
  building, extra-features, assessed, appraised, and market value, plus
  value status and whether that year was protested.

- GET /parcel/{acct}/protests
  Paid, $0.03 USDC. Every ARB protest and every hearing for the parcel,
  all years. Each hearing row carries the value before the protest and
  the value after it. "protested_by" / "filed_by" is a role (Agent or
  Owner), never a name.

- GET /area/{neighborhood}/protest-stats
  Paid, $0.05 USDC. For one HCAD neighborhood code, by tax year: hearing
  count, how many ended in a reduction, the reduction rate, and the
  median dollar reduction. Aggregates only.

## Ids

An acct is a 13-digit HCAD account number, e.g. 0010020000001. A
neighborhood code comes from GET /parcel/{acct}.

## Payment

- Protocol: x402
- Network: Base mainnet (eip155:8453)
- Asset: USDC
- Facilitator: Coinbase CDP