> ## 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.

# Empresas de Connecticut

> Toda empresa do registro da Secretaria do Estado de Connecticut, cerca de 1,3 milhão em qualquer situação, com seus principais e agentes registrados: busque empresas por nome, situação, tipo, número de conta e data de registro, encontre todas as empresas das quais uma pessoa é principal, e leia uma empresa com sua gente.

A Secretaria do Estado de Connecticut mantém o registro de toda empresa
constituída em Connecticut ou registrada para operar lá, em todas as situações,
e o publica com as pessoas que cada empresa informa: seus principais
(diretores, conselheiros, membros, administradores) e seus agentes registrados.
Cada coluna que o registro publica é mantida: constituição, endereços, e-mail,
código NAICS, a pesquisa de propriedade, ações autorizadas. Busque o nome de uma
pessoa entre os principais para achar todas as empresas das quais ela faz
parte. Atualizado semanalmente.

<Note>
  A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](/pt/datasets).
</Note>

## Buscar empresas

`POST /us/ct-sos/businesses-search/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

Busca em todas as empresas por qualquer combinação de nome, situação, tipo,
número de conta e data de registro.

| Campo            | Tipo    | Notas                                                                                                             |
| ---------------- | ------- | ----------------------------------------------------------------------------------------------------------------- |
| `query`          | string  | Opcional. Palavras do nome da empresa. Todas devem coincidir; sem stemming.                                       |
| `status`         | string  | Opcional. p. ex. `Active`, `Forfeited`, `Dissolved`, `Withdrawn`, `Revoked`, `Merged`. Não diferencia maiúsculas. |
| `business_type`  | string  | Opcional. O tipo de empresa como o registro o escreve, p. ex. `LLC`, `Stock`.                                     |
| `account_number` | string  | Opcional. O número de conta da empresa, só dígitos.                                                               |
| `from_date`      | string  | Opcional. Data mais antiga de registro, yyyy-mm-dd.                                                               |
| `to_date`        | string  | Opcional. Data mais recente de registro, yyyy-mm-dd.                                                              |
| `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/ct-sos/businesses-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "insurance" }'
```

Retorna `as_of`, os filtros aplicados, `total`, `page`, `per_page`, `total_pages`, `count` e `businesses[]`, por nome.

Cada empresa traz `id`, `name`, `business_type`, `status`, `sub_status`, `account_number`, `date_registration`, `annual_report_due_date`, `began_transacting_in_ct`, `date_of_organization_meeting`, `dissolution_date`, `reason_for_administrative`, `business_email`, sua constituição (`business_name_in_state_country`, `citizenship`, `country_formation`, `formation_place`, `state_or_territory_formation`), `billing_address` e `records_address` (`{ street, unit, city, state, postal_code, country }`), `record_address`, os endereços de jurisdição postal e de escritório como o registro os escreve (`mailing_*`, `office_*`), `naics_code`, `naics_sub_code`, a pesquisa de propriedade (`woman_owned`, `veteran_owned`, `minority_owned`, `disability_owned`, `lgbtqi_owned`, `category_survey_email`), `total_authorized_shares`, `latitude` e `longitude`.

Os campos vazios são `null`. Situações e tipos vão em maiúsculas.

## Uma empresa e sua gente

`POST /us/ct-sos/business/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

Resolve uma empresa pelo seu id, com seus principais e agentes.

| Campo | Tipo   | Notas                                                                    |
| ----- | ------ | ------------------------------------------------------------------------ |
| `id`  | string | **Obrigatório.** O id do registro da empresa, como retornado pela busca. |

```bash theme={"dark"}
curl https://api.croma.run/us/ct-sos/business/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "id": "001t000000WmbJKAAZ" }'
```

Retorna `found`, `id`, `as_of`, `business` (null quando não encontrado), `principals[]`, `principals_total` e `agents[]`.

Cada empresa traz `id`, `name`, `business_type`, `status`, `sub_status`, `account_number`, `date_registration`, `annual_report_due_date`, `began_transacting_in_ct`, `date_of_organization_meeting`, `dissolution_date`, `reason_for_administrative`, `business_email`, sua constituição (`business_name_in_state_country`, `citizenship`, `country_formation`, `formation_place`, `state_or_territory_formation`), `billing_address` e `records_address` (`{ street, unit, city, state, postal_code, country }`), `record_address`, os endereços de jurisdição postal e de escritório como o registro os escreve (`mailing_*`, `office_*`), `naics_code`, `naics_sub_code`, a pesquisa de propriedade (`woman_owned`, `veteran_owned`, `minority_owned`, `disability_owned`, `lgbtqi_owned`, `category_survey_email`), `total_authorized_shares`, `latitude` e `longitude`.

Os campos vazios são `null`. Situações e tipos vão em maiúsculas.

Um principal traz `id`, `business_id`, `name`, `first_name`, `middle_name`, `last_name`, `suffix`, `designation` (officer, director), `type` e `business_address` (`{ line_1, line_2, line_3, city, state, zip, country, international }`). Um agente traz `id`, `business_id`, `business_account_number`, `agent_account`, `type` (`Individual`, `Business` ou `Secretary of the State`), `name` e suas partes, `phone`, `email`, e seus endereços comercial e postal. Os endereços residenciais não são retornados.

## Encontrar as empresas de uma pessoa

`POST /us/ct-sos/principals-search/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

Busca entre os principais pelo nome.

| Campo      | Tipo    | Notas                                                                         |
| ---------- | ------- | ----------------------------------------------------------------------------- |
| `query`    | string  | Opcional. Palavras do nome do principal. Todas devem coincidir; sem stemming. |
| `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/ct-sos/principals-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "john smith" }'
```

Retorna `as_of`, `query`, `total`, `page`, `per_page`, `total_pages`, `count` e `principals[]`, cada um com `business_name` e `business_status`.

Um principal traz `id`, `business_id`, `name`, `first_name`, `middle_name`, `last_name`, `suffix`, `designation` (officer, director), `type` e `business_address` (`{ line_1, line_2, line_3, city, state, zip, country, international }`). Um agente traz `id`, `business_id`, `business_account_number`, `agent_account`, `type` (`Individual`, `Business` ou `Secretary of the State`), `name` e suas partes, `phone`, `email`, e seus endereços comercial e postal. Os endereços residenciais não são retornados.

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, todos os campos de resposta e um playground interativo.
</Card>