New-Business Lead Feed

GET /api/v1/leads/new-businesses

Lead Feed tier endpoint. Returns newly-registered Florida businesses filtered by county (FL only), city, entity type, and filing date range. The county filter uses a dual branch: fast equality on Address.county when that column is populated, with a ZIP-set fallback (Address.postalCode = ANY($zips)) for rows where county is NULL.

Authentication

curl -H "X-API-Key: fbapi_live_..." \
  "https://api.floridabusinessapi.com/v1/leads/new-businesses?county=Hillsborough&entity_type=FLAL&date_from=2026-06-01&limit=100"

Query Parameters

Name	Type	Required	Default	Description
county	string (max 40 chars)	no	—	FL county name (case-insensitive; "County" suffix stripped).
city	string (max 60 chars)	no	—	City name (case-insensitive).
entity_type	string (max 20 chars)	no	—	FL entity type code, e.g. FLAL. Send UPPERCASE.
date_from	string YYYY-MM-DD	no	—	Inclusive lower bound on filing date.
date_to	string YYYY-MM-DD	no	—	Inclusive upper bound on filing date (half-open: < date_to + 1d).
limit	integer 1-500	no	25	Page size.
offset	integer ≥ 0	no	0	Pagination offset.

Response (200)

{
  "data": [
    {
      "document_number": "L26000123456",
      "entity_name": "ACME LOGISTICS LLC",
      "entity_type": "FLAL",
      "filing_date": "2026-06-24",
      "city": "TAMPA",
      "state": "FL",
      "zip": "33602",
      "county": "Hillsborough"
    }
  ],
  "pagination": { "limit": 25, "offset": 0, "total": 1, "has_more": false },
  "meta": { "request_id": "req_1234567890abcdef12345" }
}

Sorted by filing_date DESC (most recent first), then document_number ASC for stable pagination.

Error Responses

Status	Code	Cause
400	bad_request	Invalid query parameters / date format.
401	unauthorized	Missing or invalid API key.
429	rate_limited	Quota or rate limit exceeded.
500	internal_error	Server error — retry with backoff.