Get Entity by Document Number

GET /api/v1/entities/{document_number}

Returns full detail for a single Florida business entity. The response includes the principal and mailing addresses, registered agent (with their address), officers (name + title only — addresses are NOT returned per Pitfall 4-H PII gate), and the 50 most-recent filing events.

Authentication

curl -H "X-API-Key: fbapi_live_..." \
  "https://api.floridabusinessapi.com/v1/entities/L26000123456"

Path Parameters

Name	Type	Required	Description
document_number	string (6-12 alphanumeric)	yes	FL Division of Corporations document number.

Response (200)

Single-object envelope { data: EntityDetail, meta }. Example:

{
  "data": {
    "document_number": "L26000123456",
    "entity_name": "ACME LOGISTICS LLC",
    "status": "active",
    "entity_type": "FLAL",
    "filing_date": "2026-06-24",
    "principal_address": { "line1": "123 MAIN ST", "city": "TAMPA", "state": "FL", "postal_code": "33602" },
    "mailing_address":   { "line1": "123 MAIN ST", "city": "TAMPA", "state": "FL", "postal_code": "33602" },
    "registered_agent":  { "name": "JOHN SMITH", "address": { "line1": "456 OAK AVE", "city": "TAMPA", "state": "FL", "postal_code": "33602" } },
    "officers": [ { "name": "JANE DOE", "title": "MGR" } ],
    "recent_filings": [ { "event_type": "FORMATION", "event_date": "2026-06-24", "document_number": "L26000123456", "description": "Articles of Organization" } ]
  },
  "meta": { "request_id": "req_1234567890abcdef12345" }
}

Officers carry only { name, title } — never address. Officer addresses are considered PII and are gated at three layers (Zod response schema, route handler shaping, and a per-officer key-equality test in src/lib/search/__tests__/).

Error Responses

Status	Code	Cause
400	bad_request	Invalid document_number format.
401	unauthorized	Missing or invalid API key.
404	not_found	No entity with that document_number.
429	rate_limited	Quota or rate limit exceeded.
500	internal_error	Server error — retry with backoff.