Search Registered Agents

GET /api/v1/agents/search

Search Florida registered agents by name (fuzzy via pg_trgm). Each result row aggregates: the agent's identity (name), the count of currently-linked entities (linked_entity_count), and the agent's primary mailing address.

Authentication

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

Query Parameters

Name	Type	Required	Default	Description
name	string (1-200 chars)	no	—	Agent name (case-insensitive fuzzy match).
limit	integer 1-500	no	25	Page size.
offset	integer ≥ 0	no	0	Pagination offset.

Response (200)

{
  "data": [
    {
      "agent_name": "JOHN SMITH",
      "linked_entity_count": 128,
      "city": "TAMPA",
      "state": "FL",
      "zip": "33602"
    }
  ],
  "pagination": { "limit": 25, "offset": 0, "total": 1, "has_more": false },
  "meta": { "request_id": "req_1234567890abcdef12345" }
}

Results are ranked by exact > prefix > trigram similarity (primary), then by linked_entity_count DESC (secondary), then by agent_name ASC.

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.