---
title: "Sunbiz Entities Search"
method: POST
path: "/us/sunbiz/entities-search/v1"
tags: ["United States", "Sunbiz (Florida Division of Corporations)"]
---

# Sunbiz Entities Search

`POST /us/sunbiz/entities-search/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/us/sunbiz/entities-search/v1`
- Auth: HTTP bearer

Search Florida's registry of business entities (Sunbiz, the Division of Corporations) by free text over the entity name, its officers and its registered agent, by name prefix, status (active/inactive), filing type (LLC, corporation, partnership, trust...), city and state of the principal address, FEI number, formation-date window and last-published date. Pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date daily.

**Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `query` string: Palabras a buscar en el nombre de la entidad, sus directivos y su agente registrado (opcional).
  - `name_prefix` string: Inicio del nombre de la entidad, p. ej. `VIVA EXHIBITIONS` (opcional).
  - `status` '' | 'active' | 'inactive': Estado de la entidad: `active` o `inactive` (opcional).
  - `filing_type` '' | 'florida_llc' | 'foreign_llc' | 'domestic_profit' | 'foreign_profit' | 'domestic_nonprofit' | 'foreign_nonprofit' | 'domestic_limited_partnership' | 'foreign_limited_partnership' | 'nonprofit_registration' | 'trust' | 'registered_agent_designation': Tipo de registro: `florida_llc`, `foreign_llc`, `domestic_profit`, `foreign_profit`, `domestic_nonprofit`, `foreign_nonprofit`, `domestic_limited_partnership`, `foreign_limited_partnership`, `nonprofit_registration`, `trust` o `registered_agent_designation` (opcional).
  - `city` string: Ciudad de la dirección principal, p. ej. `MIAMI` (opcional).
  - `state` string: Código de estado de dos letras, p. ej. `FL` (opcional).
  - `fei_number` string: FEI/EIN de nueve dígitos de la entidad (opcional).
  - `filed_from` string, date: Optional date filter in yyyy-mm-dd format.
  - `filed_to` string, date: Optional date filter in yyyy-mm-dd format.
  - `updated_after` string, date: Optional date filter in yyyy-mm-dd format.
  - `page` integer: 1-based page number for paginated results.
  - `per_page` integer: Resultados por página (1-50).

## Response `200`

Successful response

- SunbizEntitiesSearchResponse
  - `data` SunbizEntitiesSearchData, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `query` string, required
    - `name_prefix` string, nullable, required
    - `status` string, nullable, required
    - `filing_type` string, nullable, required
    - `city` string, nullable, required
    - `state` string, nullable, required
    - `fei_number` string, nullable, required
    - `filed_from` string, nullable, required
    - `filed_to` string, nullable, required
    - `updated_after` string, nullable, required
    - `total` number, required: Entities matching the filters, across every page, counted up to 1000.
    - `total_is_exact` boolean, required: False when more than 1000 match: `total` is then 1000, and the pages go on.
    - `page` number, required
    - `per_page` number, required
    - `total_pages` number, required: Pages over `total`; there are more when `total_is_exact` is false.
    - `count` number, required
    - `entities` object[], required
      - `document_number` string, required: The registry's own key for the entity, e.g. `P26000044030`. Its letter says what was filed (`P` profit corporation, `L` Florida LLC, `M` foreign LLC, `N` nonprofit, `F` foreign corporation, ...).
      - `name` string, required: The entity's name as registered.
      - `status` 'active' | 'inactive', required: `active` or `inactive`.
      - `filing_type` string, required: What was filed: `florida_llc`, `foreign_llc`, `domestic_profit`, `foreign_profit`, `domestic_nonprofit`, `foreign_nonprofit`, `domestic_limited_partnership`, `foreign_limited_partnership`, `nonprofit_registration`, `trust` or `registered_agent_designation`.
      - `jurisdiction` string, nullable, required: Where the entity was formed: `FL` for a Florida entity, another state's code, or a country code for one formed abroad.
      - `principal_address` object, required
        - `line_1` string, nullable, required
        - `line_2` string, nullable, required
        - `city` string, nullable, required: City of the principal address, as the registry prints it.
        - `state` string, nullable, required: State of the principal address.
        - `zip` string, nullable, required: `12345` or `12345-6789`; a foreign postal code as printed.
        - `country` string, nullable, required: Two-letter country code when the registry prints one.
      - `mailing_address` object, required
        - `line_1` string, nullable, required
        - `line_2` string, nullable, required
        - `city` string, nullable, required
        - `state` string, nullable, required: Two-letter state code, as the registry prints it.
        - `zip` string, nullable, required: `12345` or `12345-6789`; a foreign postal code as printed.
        - `country` string, nullable, required: Two-letter country code when the registry prints one.
      - `filed_on` string, nullable, required: `yyyy-mm-dd` of the formation or registration filing; an entity filed with a delayed effective date carries that later date, which can be months ahead.
      - `fei_number` string, nullable, required: Federal Employer Identification Number, nine digits, when the entity reported one.
      - `last_transaction_on` string, nullable, required: `yyyy-mm-dd` of the last filing the registry recorded on the entity.
      - `annual_reports` object[], required: The last three annual reports: the report year and the date it was filed.
        - `year` integer, required
        - `filed_on` string, nullable, required
      - `registered_agent` object, nullable, required
        - `kind` 'person' | 'company', nullable, required: Whether the registry lists a person or a company.
        - `name` string, required: The registered agent's name as one string; the search reaches it.
        - `first_name` string, nullable, required: Persons only.
        - `middle_name` string, nullable, required: Persons only; often an initial.
        - `last_name` string, nullable, required: Persons only.
        - `address` object, required
          - `line_1` string, nullable, required
          - `city` string, nullable, required
          - `state` string, nullable, required
          - `zip` string, nullable, required
      - `officers` object[], required: Up to six officers, directors, managers or members, as the registry lists them.
        - `kind` 'person' | 'company', nullable, required: Whether the registry lists a person or a company.
        - `name` string, required: The name as one string: `FIRST MIDDLE LAST` for a person, the company name otherwise.
        - `first_name` string, nullable, required: Persons only.
        - `middle_name` string, nullable, required: Persons only; often an initial.
        - `last_name` string, nullable, required: Persons only.
        - `address` object, required
          - `line_1` string, nullable, required
          - `city` string, nullable, required
          - `state` string, nullable, required
          - `zip` string, nullable, required
        - `title` string, nullable, required: The office as the registry abbreviates it: `P` (president), `VP`, `MGR` (manager), `AMBR` (authorized member), `MBR`, `D` (director), `T`, `S`, `CEO`, `AR`, ...
      - `officer_names` string[], required: Every officer's name; the search reaches them.
      - `more_than_six_officers` boolean, required: The registry lists more officers than the six it publishes here.
      - `updated_at` string, required: When the registry published the state this record reflects (ISO timestamp).

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)