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

# Entidades de Colorado

> Toda entidad comercial registrada alguna vez ante la Secretaría de Estado de Colorado, unas 3,1 millones desde 1864, en cualquier estado: busca por nombre, estado, tipo, jurisdicción y fecha de constitución, y lee las direcciones y el agente registrado de una entidad.

La Secretaría de Estado de Colorado lleva el registro de toda sociedad, LLC,
entidad sin ánimo de lucro, sociedad de personas y demás entidad constituida en
Colorado o registrada para operar allí, y lo conserva en todos sus estados: al
día, morosa, disuelta, retirada, fusionada, convertida. Para cada una: su nombre
e id, estado, tipo, dónde y cuándo se constituyó, sus direcciones principal y de
correspondencia, y su agente registrado con sus direcciones. Se actualiza a
diario.

<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 entidades

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

Busca en todas las entidades por cualquier combinación de nombre, estado,
tipo, jurisdicción y fecha de constitución.

| Campo          | Tipo    | Notas                                                                                                                                                        |
| -------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `query`        | string  | Opcional. Palabras del nombre de la entidad. Todas deben coincidir; sin lematización.                                                                        |
| `status`       | string  | Opcional. p. ej. `Good Standing`, `Delinquent`, `Voluntarily Dissolved`, `Administratively Dissolved`, `Withdrawn`, `Noncompliant`. No distingue mayúsculas. |
| `entity_type`  | string  | Opcional. El tipo de entidad como lo escribe el registro, p. ej. `Limited Liability Company`.                                                                |
| `jurisdiction` | string  | Opcional. Dónde se constituyó la entidad, p. ej. `CO`, `DE`.                                                                                                 |
| `from_date`    | string  | Opcional. Fecha más temprana de constitución, yyyy-mm-dd.                                                                                                    |
| `to_date`      | string  | Opcional. Fecha más tardía de constitución, 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/colorado-sos/entities-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "acme" }'
```

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

Cada entidad incluye `entity_id`, `name`, `status`, `entity_type`, `jurisdiction_of_formation`, `formation_date`, `principal_address` y `mailing_address` (cada una `{ line_1, line_2, city, state, zip, country }` o null) y `agent` (`{ name, first_name, middle_name, last_name, suffix, organization_name, principal_address, mailing_address }`, o null).

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

## Una entidad

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

Resuelve una entidad por su id.

| Campo       | Tipo   | Notas                                               |
| ----------- | ------ | --------------------------------------------------- |
| `entity_id` | string | **Obligatorio.** El id de la entidad, solo dígitos. |

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

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

Cada entidad incluye `entity_id`, `name`, `status`, `entity_type`, `jurisdiction_of_formation`, `formation_date`, `principal_address` y `mailing_address` (cada una `{ line_1, line_2, city, state, zip, country }` o null) y `agent` (`{ name, first_name, middle_name, last_name, suffix, organization_name, principal_address, mailing_address }`, o null).

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

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