Tax-Delinquency Counts

GET /api/v1/tax-delinquencies/counts

Return grouped record counts by delinquency status, optionally scoped to a county slug and/or tax year. Useful for dashboards and for sizing a paginated search sweep before you run it.

Authentication

curl -H "X-API-Key: fpapi_test_..." \
  "https://api.floridapropertyapi.com/v1/tax-delinquencies/counts?county=polk&tax_year=2023"

Query Parameters

Name	Type	Required	Default	Description
county	string	no	—	County slug to scope the counts.
tax_year	integer	no	—	Tax year to scope the counts.

Response (200)

Object envelope { data, meta }. data echoes the applied scope (county, tax_year — null when not set) and an array of { status, count } buckets ordered by descending count.

{
  "data": {
    "county": "polk",
    "tax_year": 2023,
    "counts": [
      { "status": "certificate_sold", "count": 18452 },
      { "status": "delinquent", "count": 7310 },
      { "status": "redeemed", "count": 4129 },
      { "status": "unknown", "count": 86 }
    ]
  },
  "meta": { "request_id": "req_1234567890abcdef12345", "dataset_status": "live" }
}

Rows with no recorded status are bucketed under unknown.

Error Responses

Status	Code	Cause
401	unauthorized	Missing or invalid API key.
429	rate_limited	Rate limit exceeded.
500	internal_error	Server error — retry with backoff.