The parcel API
Read-only JSON access to Texas ARB hearing results, county coverage, and premium no-show / failed-to-reduce leads. Multi-year, multi-county. Included free with any 10+ county license, or as a season add-on.
Data endpoints are versioned under /v1. Responses are application/json.
Every /v1 endpoint except /v1/health needs an API key — sent as a Bearer token or an x-api-key header:
Keys are scoped feed (coverage, county detail, hearings) or premium (adds the leads + portfolio endpoints). Stored as a SHA-256 hash — plaintext is never persisted.
Endpoints
| Endpoint | Scope | What it returns |
|---|---|---|
GET/v1/health | open | Liveness probe — status, version, time. No auth. |
GET/v1/counties | feed | Coverage list: every TX county with fips, name, tier, status, and whether a live hearings feed exists. |
GET/v1/counties/:fips | feed | County detail + stats (total / reduced / no-change / raised / pending / leads) and feed freshness. |
GET/v1/counties/:fips/hearings | feed | Paginated ARB results: date, disposition, board determination, noticed value, and the cut. limit/offset. |
GET/v1/counties/:fips/leads | premium | Premium prospect list — owners who failed to reduce or were a no-show, each with a reason. Premium key required. |
POST/v1/portfolio/process | premium | Upload a book of properties (JSON or CSV); geocoded, county-matched to coverage, and grouped as a "what to license" suggestion. |
Quick start
# health (open) curl https://api.txtaxfight.com/v1/health # coverage list curl -H "Authorization: Bearer $KEY" \ https://api.txtaxfight.com/v1/counties # hearings, paginated (Jefferson County) curl -H "Authorization: Bearer $KEY" \ "https://api.txtaxfight.com/v1/counties/48245/hearings?limit=25&offset=0"
Rate limits: 60 req/min per key (configurable) plus a per-IP flood cap; over-limit returns 429 with Retry-After. Coverage expands as counties onboard — counties without a live feed return an empty set with total: 0. No fabricated data.