> ## 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
> O registro de entidades da Flórida: busque corporações, LLCs, sociedades e trusts por nome, dirigente ou agente registrado, e consulte uma pelo seu número de documento.
Cada entidade registrada na Florida Division of Corporations (Sunbiz):
corporações, sociedades de responsabilidade limitada, sociedades e trusts,
locais e estrangeiras, ativas e inativas, com o status, os endereços, a data de
constituição, o FEI, o agente registrado e os dirigentes que a Divisão publica
de cada uma.
Todo o registro, organizado e pronto para consultar, atualizado todos os dias.
É isso que transforma uma busca em todas as entidades pelo nome de um dirigente
ou de um agente registrado, ou todas as LLCs constituídas em Miami neste
trimestre, em uma única chamada rápida.
## Buscar entidades
`POST /us/sunbiz/entities-search/v1`
Busca no registro por qualquer combinação de texto, prefixo do nome, status,
tipo de registro, cidade, estado, FEI e datas.
| Campo | Tipo | Notas |
| --------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Opcional. Palavras a buscar no nome da entidade, nos nomes dos seus dirigentes e no do seu agente registrado. Todas as palavras devem coincidir; sem lematização. |
| `name_prefix` | string | Opcional. O início do nome da entidade, como a busca do próprio registro o encontra. Os resultados vêm em ordem alfabética. |
| `status` | enum | Opcional. `active` ou `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` ou `registered_agent_designation`. |
| `city` | string | Opcional. Cidade do endereço principal como o registro a escreve, p. ex. `MIAMI`, `TAMPA`. |
| `state` | string | Opcional. Estado do endereço principal, duas letras, p. ex. `FL`. |
| `fei_number` | string | Opcional. O FEI/EIN de nove dígitos da entidade, com ou sem hífen. |
| `filed_from` | string | Opcional. Limite inferior da data de constituição (`yyyy-mm-dd`, inclusive). |
| `filed_to` | string | Opcional. Limite superior da data de constituição (`yyyy-mm-dd`, inclusive). |
| `updated_after` | string | Opcional. Apenas entidades para as quais o registro publicou uma mudança nesta data ou depois: o que mudou desde a sua última consulta. |
| `page` | integer | Opcional. Página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-50. Por padrão `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"
}'
```
A fonte inteira, organizada e pronta para consultar: este endpoint responde em milissegundos, a qualquer hora e sempre igual. Cada resposta traz `as_of`: o quão atuais são os dados.
Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` (correspondências em todas as páginas), `page`, `per_page`, `total_pages`, `count` e `entities[]`. Com `name_prefix`, em ordem alfabética; caso contrário, as constituídas mais recentemente primeiro.
Cada entidade traz `document_number` (a chave do registro), `name`, `status` (`active` ou `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`, o código de outro estado, ou um código de país para uma entidade constituída no exterior), `principal_address` e `mailing_address` (`{ line_1, line_2, city, state, zip, country }`), `filed_on`, `fei_number`, `last_transaction_on`, `annual_reports[]` (`{ year, filed_on }`, os três últimos), `registered_agent` (`{ kind, name, first_name, middle_name, last_name, address }`), `officers[]` (a mesma forma mais `title`, o cargo como o registro o abrevia: `P`, `VP`, `MGR`, `AMBR`, `D`, `T`, `S`, `CEO`, ...), `officer_names[]`, `more_than_six_officers` e `updated_at` (quando o registro publicou o estado que o registro reflete).
O `name` de uma pessoa é `NOME MEIO SOBRENOME`; o de uma empresa é seu nome registrado. As datas são `yyyy-mm-dd`; um zip é `12345` ou `12345-6789`. Os campos vazios são `null`.
Todo o registro, entidades ativas e inativas igualmente, até o último arquivo
diário que a Divisão publicou. O site do registro busca nomes por prefixo, um
de cada vez; aqui uma busca alcança também cada dirigente e agente registrado.
## Entidade por número de documento
`POST /us/sunbiz/entity/v1` Resolve uma entidade pelo seu número de documento e retorna o registro completo.
| Campo | Tipo | Notas |
| ----------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------- |
| `document_number` | string | **Obrigatório.** O número de documento do registro, p. ex. `P26000044030`, como retornado pela busca. Não diferencia maiú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" }'
```
A fonte inteira, organizada e pronta para consultar: este endpoint responde em milissegundos, a qualquer hora e sempre igual. Cada resposta traz `as_of`: o quão atuais são os dados.
Retorna `found`, `document_number`, `as_of` e `entity` (null quando não encontrado).
Cada entidade traz `document_number` (a chave do registro), `name`, `status` (`active` ou `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`, o código de outro estado, ou um código de país para uma entidade constituída no exterior), `principal_address` e `mailing_address` (`{ line_1, line_2, city, state, zip, country }`), `filed_on`, `fei_number`, `last_transaction_on`, `annual_reports[]` (`{ year, filed_on }`, os três últimos), `registered_agent` (`{ kind, name, first_name, middle_name, last_name, address }`), `officers[]` (a mesma forma mais `title`, o cargo como o registro o abrevia: `P`, `VP`, `MGR`, `AMBR`, `D`, `T`, `S`, `CEO`, ...), `officer_names[]`, `more_than_six_officers` e `updated_at` (quando o registro publicou o estado que o registro reflete).
O `name` de uma pessoa é `NOME MEIO SOBRENOME`; o de uma empresa é seu nome registrado. As datas são `yyyy-mm-dd`; um zip é `12345` ou `12345-6789`. Os campos vazios são `null`.
Um número de documento que o registro não contém retorna `found: false` com
HTTP 200, não um erro.
Esquemas, todos os campos de resposta e um playground interativo.