Search Officers

GET /api/v1/officers/search

Search Florida business officers by name (fuzzy via pg_trgm) and title across all entities. Returns the officer name, title code, and the linked entity's document number + name. Officer addresses are never returned (Pitfall 4-H PII gate).

Authentication

curl -H "X-API-Key: fbapi_live_..." \
  "https://api.floridabusinessapi.com/v1/officers/search?name=SMITH&title=MGR&limit=25"

Query Parameters

Name	Type	Required	Default	Description
name	string (1-200 chars)	no	—	Officer name (case-insensitive fuzzy match).
title	string (1-20 chars)	no	—	Title code, e.g. MGR, DIR (case-insensitive).
limit	integer 1-500	no	25	Page size.
offset	integer ≥ 0	no	0	Pagination offset.

Response (200)

{
  "data": [
    {
      "officer_name": "JANE DOE",
      "title_code": "MGR",
      "document_number": "L26000123456",
      "entity_name": "ACME LOGISTICS LLC"
    }
  ],
  "pagination": { "limit": 25, "offset": 0, "total": 1, "has_more": false },
  "meta": { "request_id": "req_1234567890abcdef12345" }
}

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.