Counties

List all 67 Florida counties, or fetch one by slug, with property-appraiser and tax-collector URLs, certificate-sale vendor + URL, per-county coverage status, and certificate counts.

GET /api/v1/counties

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

The directory itself covers all 67 counties. How deep the data goes for any given county is carried by coverageStatus and certificateCount on that county's row. Read those two fields rather than assuming certificate-level data exists everywhere.

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": "clc0alachua00000000000001",
      "countyName": "Alachua",
      "countySlug": "alachua",
      "countyFips": "12001",
      "dorCountyNumber": "11",
      "propertyAppraiserUrl": "https://www.acpafl.org",
      "taxCollectorUrl": "https://www.alachuacollector.com",
      "taxCertificateSaleUrl": "https://lienhub.com/county/alachua/certsale/main",
      "taxCertificateVendor": "lienhub",
      "coverageStatus": "certificate_level",
      "certificateCount": 5853,
      "lastImportAt": "2026-06-20T05:00:00.000Z",
      "createdAt": "2026-01-12T00:00:00.000Z",
      "updatedAt": "2026-06-20T05:00:00.000Z"
    },
    {
      "id": "clc0baker0000000000000002",
      "countyName": "Baker",
      "countySlug": "baker",
      "countyFips": "12003",
      "dorCountyNumber": "12",
      "propertyAppraiserUrl": "https://www.bakerpa.com",
      "taxCollectorUrl": "https://www.bakertaxcollector.com",
      "taxCertificateSaleUrl": "https://www.taxcertsale.com/BakerTaxSale/",
      "taxCertificateVendor": "taxcertsale",
      "coverageStatus": "directory_only",
      "certificateCount": 0,
      "lastImportAt": null,
      "createdAt": "2026-01-12T00:00:00.000Z",
      "updatedAt": "2026-01-12T00:00:00.000Z"
    }
  ],
  "meta": { "request_id": "req_1234567890abcdef12345", "dataset_status": "live" }
}

Fields

Field	Type	Description
`id`	string	Internal record id. Stable, but prefer `countySlug` as your join key.
`countyName`	string	Display name, e.g. `Alachua`. Unique.
`countySlug`	string	Lowercase slug used by every `county` filter across the API. Unique.
`countyFips`	string \| null	5-digit FIPS code, e.g. `12001`.
`dorCountyNumber`	string \| null	Florida Department of Revenue county number.
`propertyAppraiserUrl`	string \| null	Official county property-appraiser site.
`taxCollectorUrl`	string \| null	Official county tax-collector site.
`taxCertificateSaleUrl`	string \| null	The county's certificate-sale (tax-lien auction) portal URL.
`taxCertificateVendor`	string \| null	Sale platform code. See values below.
`coverageStatus`	string	How deep our data goes for this county. See values below. Never null.
`certificateCount`	integer	Certificate records ingested for this county. `0` when none yet.
`lastImportAt`	string \| null	ISO-8601 timestamp of the last certificate import. `null` if never imported.
`createdAt`	string	ISO-8601 record-creation timestamp. Internal bookkeeping.
`updatedAt`	string	ISO-8601 last-modified timestamp. Internal bookkeeping.

`coverageStatus`

The single most important field on this endpoint. It tells you what you can actually expect to query for that county.

Value	Meaning
`directory_only`	Official sale-directory metadata only: tax collector, certificate-sale URL, and vendor channel. Individual certificate records are not yet ingested for this county.
`vendor_tracked`	The county's certificate-sale portal or feed is actively monitored. Certificate-level records are being onboarded from the vendor channel.
`certificate_level`	Individual tax certificate records are ingested and searchable for this county, in addition to the official sale directory.

Counties default to directory_only. A county with certificateCount: 0 will not return rows from Search Certificates; filter on coverageStatus === "certificate_level" to build a list of counties you can query end to end. See Sources for per-county feed freshness.

`taxCertificateVendor`

One of lienhub, taxcertsale, realtaxlien, wfbs, pacificblue, county_local, or manual. May be null when the channel is not yet modeled. These map to the sale platform the county uses: LienHub, Grant Street's TaxCertSale, RealAuction's RealTaxLien, Wells Fargo Business Solutions, Pacific Blue, an in-house or local county system, and a manual or in-person sale respectively.

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.