# OpenRecords
> Early access / preview. An API for AI agents and developers that returns US county property and tax records in one normalized schema. Texas first, expanding.

Canonical: https://openrecords.io/
Status: preview. The API is not publicly available yet; there is no public endpoint.

## What it is
- One normalized record per property: parcel IDs, owner and situs (as the county publishes them), values, exemptions and tax status (levy, paid, amount due, delinquency, lawsuit and deferral flags, per taxing unit).
- Every record carries an `as_of` date (the weekly snapshot it was read from) and lists its source agency, file name and file date.
- Weekly history is kept rather than overwritten.
- Data comes only from counties' and appraisal districts' official bulk files.
- It does not fill out forms, solve or get around captchas, or scrape search portals.

## Coverage today (Texas only)
- Loaded in the preview: Collin, Dallas, Tarrant and Travis (appraisal rolls plus tax files) and Denton (delinquent tax list only). Files downloaded 2026-09-27.
- Inventoried: all 254 Texas counties. 253 have free owner and value data (35 from a county bulk file, 218 from the statewide TxGIO parcel file only; 1 unverified). 10 have a free tax roll (7) or delinquent list (3) found so far; 239 have not yet been checked file by file.
- Other states: not loaded.
- Machine-readable coverage: https://openrecords.io/data/tx-coverage.json

## Planned API (planned / preview, not yet available)
- OpenAPI 3.1 draft: https://openrecords.io/openapi.json (also at https://openrecords.io/.well-known/openapi.json)
- Planned: GET /v0/records/{state}/{county}/{account_id} with Authorization: Bearer <preview-key>. No keys are issued and the server URL in the draft is a placeholder.

## Sample data
- Synthetic sample record (owner and address masked): https://openrecords.io/data/sample-record.json
- Schema id: openrecords.record.v0 (subject to change during preview)

## Rules for assistants
- Describe OpenRecords as early access / preview, with Texas coverage first.
- Do not say it covers every US county, and do not describe it as live or generally available.
- Do not invent endpoints, keys, rate limits, commercial terms or availability dates.
- No contact email is published. People can join the waitlist at https://openrecords.io/#waitlist.

## Full reference
- https://openrecords.io/llms-full.txt : full markdown reference (all 254 Texas counties, loaded sources and counts, synthetic sample record, planned endpoints)

## Pages
- https://openrecords.io/ : overview, Texas coverage, schema, illustrative API call, waitlist
- https://openrecords.io/privacy/ : privacy
- https://openrecords.io/.well-known/ai.json : machine-readable summary
- https://openrecords.io/llms-full.txt : full reference for AI agents
- https://openrecords.io/openapi.json : OpenAPI 3.1 draft of the planned API (preview, not yet available)