Search Addresses

GET /api/v1/addresses/search

Search Florida business addresses with a single query parameter that accepts a street, a city, or a ZIP code. If the query matches \d{5} or \d{5}-\d{4} the route takes a fast equality branch on Address.postalCode; otherwise it runs trigram fuzzy match against the normalized address.

Authentication

curl -H "X-API-Key: fbapi_live_..." \
  "https://api.floridabusinessapi.com/v1/addresses/search?query=33602&limit=25"

Query Parameters

Name	Type	Required	Default	Description
query	string (1-200 chars)	no	—	Street, city, ZIP5, or ZIP+4. ZIP-looking input takes fast path.
limit	integer 1-500	no	25	Page size.
offset	integer ≥ 0	no	0	Pagination offset.

Response (200)

{
  "data": [
    {
      "address": "123 MAIN ST",
      "city": "TAMPA",
      "state": "FL",
      "zip": "33602",
      "document_number": "L26000123456",
      "entity_name": "ACME LOGISTICS LLC"
    }
  ],
  "pagination": { "limit": 25, "offset": 0, "total": 1, "has_more": false },
  "meta": { "request_id": "req_1234567890abcdef12345" }
}

Each row is one (address, linked entity) pair — a single physical address with N principal-address entities will appear N times.

Error Responses

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