API documentation

Every screen in this product is backed by a metered JSON API. Calls are counted against your plan and visible on your dashboard.

Authentication

Send your key in the X-API-Key header, or as a ?key= query parameter.

curl -H "X-API-Key: YOUR_KEY" \
  "https://countyclock.com/api/v1/parcels?limit=5"

Create a free account to get a key.

Metering & limits

• Credits are charged per record returned on list endpoints; single-record endpoints cost 1.
• /api/v1/stats and /api/v1/sales are free.
• List endpoints cap at 500 records per call. Page with offset.
• Exceeding your plan returns HTTP 429 with {"error":"quota_exceeded"}.

Endpoints

GET /api/v1/stats Free

Coverage and market counts for the dataset.

curl -H "X-API-Key: $KEY" .../api/v1/stats

GET /api/v1/parcels Per record

The ranked screen. Filters below; returns compact records with meta.total for paging.

curl -H "X-API-Key: $KEY" ".../api/v1/parcels?clock30=1&oos=1&min_deal=80&sort=deal&limit=50"

GET /api/v1/parcel/{apn} 1 credit

Full record for one parcel, including legal description, council district, court-held excess proceeds and other parcels from the same owner.

curl -H "X-API-Key: $KEY" .../api/v1/parcel/06800002500

GET /api/v1/owners Per owner

Portfolio roll-up: one call returns every owner holding multiple screened parcels with combined appraised value and acreage.

curl -H "X-API-Key: $KEY" ".../api/v1/owners?min_parcels=3&oos_only=1&sort=value"

GET /api/v1/excess 1 credit

Tax-sale excess proceeds held by Davidson Chancery under T.C.A. 67-5-2702.

curl -H "X-API-Key: $KEY" ".../api/v1/excess?min_amount=10000"

GET /api/v1/sales Free

Metro Nashville delinquent tax sale schedule with newspaper publication dates.

curl -H "X-API-Key: $KEY" .../api/v1/sales

Filters for `/api/v1/parcels`

Parameter	Description
city	Nashville, Madison, Antioch, Hermitage, Joelton, Whites Creek, Goodlettsville…
zip	5-digit ZIP
vtype	RESIDENTIAL \| RURAL \| COMMERCIAL \| INDUSTRIAL \| MULTI-FAMILY
clock30	1 = only parcels eligible for the 30-day redemption clock
oos	1 = out-of-state owner
probate	1 = probate / estate / trust signal in the owner record
min_deal / min_lead	Minimum deal or lead score (0-100)
deal_grade / lead_grade	A \| B \| C \| D
max_appraised	Maximum county appraised value
min_acres	Minimum acreage
sort	deal \| lead \| cheap \| acres \| tenure \| zip
limit / offset	Page size (max 500) and offset

Example response

{
  "data": [
    {
      "apn": "06800002500",
      "address": "0 WWCR AVE",
      "city": "Nashville", "zip": "37218",
      "county": "Davidson", "state": "TN",
      "vacant_type": "COMMERCIAL",
      "acres": 2.57,
      "appraised_value": 6496,
      "assessed_value": 1624,
      "value_per_acre": 2528,
      "owner_name": "WNQM, INC.",
      "owner_city": "METAIRIE", "owner_state": "LA", "owner_zip": "70001",
      "out_of_state": true,
      "years_owned": 42.6,
      "redemption_days": 30,
      "redemption_basis": "vacant/abandoned showing→30-day redemption (T.C.A. 67-5-2701)",
      "vacancy_confidence": 3,
      "lead_score": 88, "lead_grade": "A",
      "deal_score": 95, "deal_grade": "A",
      "probate_signal": false, "trust_signal": false,
      "detail_url": "/parcel/06800002500"
    }
  ],
  "meta": { "total": 237, "limit": 50, "offset": 0, "sort": "deal", "returned": 50, "next": 50 }
}

Data provenance. Parcel attributes: Metro Nashville GIS Cadastral/Ownership Parcels service (live). Court data: Davidson County Chancery Clerk & Master. Statutory framework: T.C.A. §§ 67-5-801, 67-5-2501, 67-5-2701, 67-5-2702. The redemption figure is statutory eligibility derived from vacancy signals, not a confirmed delinquency — Davidson publishes its delinquent list only as newspaper advertising. Verify with the county before acting. Not legal advice and not a title report.