> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sunbiz

> El registro de entidades de Florida: busca corporaciones, LLC, sociedades y fideicomisos por nombre, directivo o agente registrado, y consulta una por su número de documento.

Cada entidad registrada ante la Florida Division of Corporations (Sunbiz):
corporaciones, compañías de responsabilidad limitada, sociedades y
fideicomisos, locales y extranjeras, activas e inactivas, con el estado, las
direcciones, la fecha de constitución, el FEI, el agente registrado y los
directivos que la División publica de cada una.

Todo el registro, organizado y listo para consultar, actualizado cada día. Eso
es lo que convierte una búsqueda sobre todas las entidades por el nombre de un
directivo o de un agente registrado, o todas las LLC constituidas en Miami este
trimestre, en una sola llamada rápida.

## Buscar entidades

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

Busca en el registro por cualquier combinación de texto, prefijo del nombre,
estado, tipo de registro, ciudad, estado, FEI y fechas.

| Campo           | Tipo    | Notas                                                                                                                                                                                                                                                      |
| --------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`         | string  | Opcional. Palabras a buscar en el nombre de la entidad, los nombres de sus directivos y el de su agente registrado. Todas las palabras deben coincidir; sin lematización.                                                                                  |
| `name_prefix`   | string  | Opcional. El inicio del nombre de la entidad, como lo busca el propio registro. Los resultados vienen en orden alfabético.                                                                                                                                 |
| `status`        | enum    | Opcional. `active` o `inactive`.                                                                                                                                                                                                                           |
| `filing_type`   | enum    | Opcional. `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`. |
| `city`          | string  | Opcional. Ciudad de la dirección principal tal como la escribe el registro, p. ej. `MIAMI`, `TAMPA`.                                                                                                                                                       |
| `state`         | string  | Opcional. Estado de la dirección principal, dos letras, p. ej. `FL`.                                                                                                                                                                                       |
| `fei_number`    | string  | Opcional. El FEI/EIN de nueve dígitos de la entidad, con o sin guion.                                                                                                                                                                                      |
| `filed_from`    | string  | Opcional. Límite inferior de la fecha de constitución (`yyyy-mm-dd`, inclusive).                                                                                                                                                                           |
| `filed_to`      | string  | Opcional. Límite superior de la fecha de constitución (`yyyy-mm-dd`, inclusive).                                                                                                                                                                           |
| `updated_after` | string  | Opcional. Solo entidades para las que el registro publicó un cambio en esta fecha o después: lo que cambió desde tu última consulta.                                                                                                                       |
| `page`          | integer | Opcional. Página, empieza en 1. Por defecto `1`.                                                                                                                                                                                                           |
| `per_page`      | integer | Opcional. Resultados por página, 1-50. Por defecto `20`.                                                                                                                                                                                                   |

```bash theme={"dark"}
curl https://api.croma.run/us/sunbiz/entities-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "query": "registered agents inc",
        "status": "active",
        "city": "MIAMI"
      }'
```

<Note>
  La fuente entera, organizada y lista para consultar: este endpoint responde en milisegundos, a cualquier hora y siempre igual. Cada respuesta incluye `as_of`: qué tan actualizados están los datos.
</Note>

Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` (coincidencias en todas las páginas), `page`, `per_page`, `total_pages`, `count` y `entities[]`. Con `name_prefix`, en orden alfabético; de lo contrario, las constituidas más recientemente primero.

Cada entidad incluye `document_number` (la clave del registro), `name`, `status` (`active` o `inactive`), `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`), `jurisdiction` (`FL`, el código de otro estado, o un código de país para una entidad constituida en el exterior), `principal_address` y `mailing_address` (`{ line_1, line_2, city, state, zip, country }`), `filed_on`, `fei_number`, `last_transaction_on`, `annual_reports[]` (`{ year, filed_on }`, los últimos tres), `registered_agent` (`{ kind, name, first_name, middle_name, last_name, address }`), `officers[]` (la misma forma más `title`, el cargo tal como lo abrevia el registro: `P`, `VP`, `MGR`, `AMBR`, `D`, `T`, `S`, `CEO`, ...), `officer_names[]`, `more_than_six_officers` y `updated_at` (cuándo publicó el registro el estado que refleja el registro).

El `name` de una persona es `NOMBRE SEGUNDO APELLIDO`; el de una empresa es su nombre registrado. Las fechas son `yyyy-mm-dd`; un zip es `12345` o `12345-6789`. Los campos vacíos son `null`.

<Note>
  Todo el registro, entidades activas e inactivas por igual, al último archivo
  diario que publicó la División. El sitio del registro busca nombres por
  prefijo, de uno en uno; aquí una búsqueda alcanza también a cada directivo y
  agente registrado.
</Note>

## Entidad por número de documento

`POST /us/sunbiz/entity/v1` Resuelve una entidad por su número de documento y devuelve el registro completo.

| Campo             | Tipo   | Notas                                                                                                                               |
| ----------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------- |
| `document_number` | string | **Obligatorio.** El número de documento del registro, p. ej. `P26000044030`, como lo devuelve la búsqueda. No distingue mayúsculas. |

```bash theme={"dark"}
curl https://api.croma.run/us/sunbiz/entity/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_number": "P26000044030" }'
```

<Note>
  La fuente entera, organizada y lista para consultar: este endpoint responde en milisegundos, a cualquier hora y siempre igual. Cada respuesta incluye `as_of`: qué tan actualizados están los datos.
</Note>

Devuelve `found`, `document_number`, `as_of` y `entity` (null cuando no se encuentra).

Cada entidad incluye `document_number` (la clave del registro), `name`, `status` (`active` o `inactive`), `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`), `jurisdiction` (`FL`, el código de otro estado, o un código de país para una entidad constituida en el exterior), `principal_address` y `mailing_address` (`{ line_1, line_2, city, state, zip, country }`), `filed_on`, `fei_number`, `last_transaction_on`, `annual_reports[]` (`{ year, filed_on }`, los últimos tres), `registered_agent` (`{ kind, name, first_name, middle_name, last_name, address }`), `officers[]` (la misma forma más `title`, el cargo tal como lo abrevia el registro: `P`, `VP`, `MGR`, `AMBR`, `D`, `T`, `S`, `CEO`, ...), `officer_names[]`, `more_than_six_officers` y `updated_at` (cuándo publicó el registro el estado que refleja el registro).

El `name` de una persona es `NOMBRE SEGUNDO APELLIDO`; el de una empresa es su nombre registrado. Las fechas son `yyyy-mm-dd`; un zip es `12345` o `12345-6789`. Los campos vacíos son `null`.

<Note>
  Un número de documento que el registro no contiene devuelve `found: false`
  con HTTP 200, no un error.
</Note>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, todos los campos de respuesta y un playground interactivo.
</Card>
