> ## 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 del registro de la Secretaría del Estado de Connecticut, unas 1,3 millones en cualquier estado, con sus principales y agentes registrados: busca empresas por nombre, estado, tipo, número de cuenta y fecha de registro, encuentra todas las empresas de las que una persona es principal, y lee una empresa con su gente.

La Secretaría del Estado de Connecticut lleva el registro de toda empresa
constituida en Connecticut o registrada para operar allí, en todos sus estados,
y lo publica con las personas que cada empresa reporta: sus principales
(directivos, directores, miembros, administradores) y sus agentes registrados.
Se conserva cada columna que publica el registro: constitución, direcciones,
correo, código NAICS, la encuesta de propiedad, acciones autorizadas. Busca el
nombre de una persona entre los principales para encontrar todas las empresas de
las que forma parte. Se actualiza cada semana.

<Note>
  La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye `as_of`: qué tan actualizados están los datos. [Cómo funcionan los datasets](/es/datasets).
</Note>

## Buscar empresas

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

Busca en todas las empresas por cualquier combinación de nombre, estado, tipo,
número de cuenta y fecha de registro.

| Campo            | Tipo    | Notas                                                                                                           |
| ---------------- | ------- | --------------------------------------------------------------------------------------------------------------- |
| `query`          | string  | Opcional. Palabras del nombre de la empresa. Todas deben coincidir; sin lematización.                           |
| `status`         | string  | Opcional. p. ej. `Active`, `Forfeited`, `Dissolved`, `Withdrawn`, `Revoked`, `Merged`. No distingue mayúsculas. |
| `business_type`  | string  | Opcional. El tipo de empresa como lo escribe el registro, p. ej. `LLC`, `Stock`.                                |
| `account_number` | string  | Opcional. El número de cuenta de la empresa, solo dígitos.                                                      |
| `from_date`      | string  | Opcional. Fecha más temprana de registro, yyyy-mm-dd.                                                           |
| `to_date`        | string  | Opcional. Fecha más tardía de registro, yyyy-mm-dd.                                                             |
| `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/ct-sos/businesses-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "insurance" }'
```

Devuelve `as_of`, los filtros aplicados, `total`, `page`, `per_page`, `total_pages`, `count` y `businesses[]`, por nombre.

Cada empresa incluye `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`, su constitución (`business_name_in_state_country`, `citizenship`, `country_formation`, `formation_place`, `state_or_territory_formation`), `billing_address` y `records_address` (`{ street, unit, city, state, postal_code, country }`), `record_address`, las direcciones de jurisdicción postal y de oficina como las escribe el registro (`mailing_*`, `office_*`), `naics_code`, `naics_sub_code`, la encuesta de propiedad (`woman_owned`, `veteran_owned`, `minority_owned`, `disability_owned`, `lgbtqi_owned`, `category_survey_email`), `total_authorized_shares`, `latitude` y `longitude`.

Los campos vacíos son `null`. Los estados y tipos van en mayúsculas.

## Una empresa y su gente

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

Resuelve una empresa por su id, con sus principales y agentes.

| Campo | Tipo   | Notas                                                                            |
| ----- | ------ | -------------------------------------------------------------------------------- |
| `id`  | string | **Obligatorio.** El id del registro de la empresa, como lo devuelve la búsqueda. |

```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" }'
```

Devuelve `found`, `id`, `as_of`, `business` (null cuando no se encuentra), `principals[]`, `principals_total` y `agents[]`.

Cada empresa incluye `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`, su constitución (`business_name_in_state_country`, `citizenship`, `country_formation`, `formation_place`, `state_or_territory_formation`), `billing_address` y `records_address` (`{ street, unit, city, state, postal_code, country }`), `record_address`, las direcciones de jurisdicción postal y de oficina como las escribe el registro (`mailing_*`, `office_*`), `naics_code`, `naics_sub_code`, la encuesta de propiedad (`woman_owned`, `veteran_owned`, `minority_owned`, `disability_owned`, `lgbtqi_owned`, `category_survey_email`), `total_authorized_shares`, `latitude` y `longitude`.

Los campos vacíos son `null`. Los estados y tipos van en mayúsculas.

Un principal incluye `id`, `business_id`, `name`, `first_name`, `middle_name`, `last_name`, `suffix`, `designation` (officer, director), `type` y `business_address` (`{ line_1, line_2, line_3, city, state, zip, country, international }`). Un agente incluye `id`, `business_id`, `business_account_number`, `agent_account`, `type` (`Individual`, `Business` o `Secretary of the State`), `name` y sus partes, `phone`, `email`, y sus direcciones comercial y postal. Las direcciones de residencia no se devuelven.

## Encontrar las empresas de una persona

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

Busca entre los principales por nombre.

| Campo      | Tipo    | Notas                                                                                 |
| ---------- | ------- | ------------------------------------------------------------------------------------- |
| `query`    | string  | Opcional. Palabras del nombre del principal. Todas deben coincidir; sin lematización. |
| `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/ct-sos/principals-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "john smith" }'
```

Devuelve `as_of`, `query`, `total`, `page`, `per_page`, `total_pages`, `count` y `principals[]`, cada uno con `business_name` y `business_status`.

Un principal incluye `id`, `business_id`, `name`, `first_name`, `middle_name`, `last_name`, `suffix`, `designation` (officer, director), `type` y `business_address` (`{ line_1, line_2, line_3, city, state, zip, country, international }`). Un agente incluye `id`, `business_id`, `business_account_number`, `agent_account`, `type` (`Individual`, `Business` o `Secretary of the State`), `name` y sus partes, `phone`, `email`, y sus direcciones comercial y postal. Las direcciones de residencia no se devuelven.

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