Counties

GET /api/v1/counties

List all 67 Florida counties carried by the dataset, alphabetical by name. Each row exposes the county slug and display name plus coverage metadata: FIPS code, FDOR county number, the tax-collector URL, the certificate-sale (tax-lien auction) vendor and portal URL, the tracked certificate count, and the last import time.

Authentication

curl -H "X-API-Key: fltc_test_..." \
  "https://fltaxcerts.com/api/v1/counties"

Fetch a single county by its slug:

curl -H "X-API-Key: fltc_test_..." \
  "https://fltaxcerts.com/api/v1/counties/hillsborough"

Parameters

Name	In	Type	Required	Description
county	path	string	yes	County slug — /counties/{county} only.

GET /api/v1/counties takes no parameters.

Response (200)

Object envelope { data, meta }. data is the array of county rows for the list route, or a single county object for /counties/{county}.

{
  "data": [
    {
      "id": "ckhills0001",
      "countyName": "Hillsborough",
      "countySlug": "hillsborough",
      "countyFips": "12057",
      "dorCountyNumber": "29",
      "taxCollectorUrl": "https://hillstax.org/",
      "certSaleUrl": "https://hillsborough.realtaxlien.com/",
      "certSaleVendor": "realauction",
      "certificateCount": 38214,
      "lastImportAt": "2026-06-20T05:00:00.000Z",
      "createdAt": "2026-01-12T00:00:00.000Z",
      "updatedAt": "2026-06-20T05:00:00.000Z"
    }
  ],
  "meta": { "request_id": "req_1234567890abcdef12345", "dataset_status": "live" }
}

certSaleVendor is one of lienhub, realauction, taxcertsale, wfbs, or county-local. certificateCount is 0 for counties whose certificate feed is not yet ingested — see Sources for per-county coverage.

Error Responses

Status	Code	Cause
401	unauthorized	Missing or invalid API key.
404	not_found	No county with that slug (/counties/{county}).
429	rate_limited	Rate limit exceeded.
500	internal_error	Server error — retry with backoff.