> ## 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 do Colorado

> Toda entidade empresarial já registrada na Secretaria de Estado do Colorado, cerca de 3,1 milhões desde 1864, em qualquer situação: busque por nome, situação, tipo, jurisdição e data de constituição, e leia os endereços e o agente registrado de uma entidade.

A Secretaria de Estado do Colorado mantém o registro de toda sociedade, LLC,
entidade sem fins lucrativos, sociedade de pessoas e demais entidade constituída
no Colorado ou registrada para operar lá, e o conserva em todas as situações:
regular, inadimplente, dissolvida, retirada, incorporada, convertida. Para cada
uma: seu nome e id, situação, tipo, onde e quando foi constituída, seus
endereços principal e de correspondência, e seu agente registrado com seus
endereços. Atualizado diariamente.

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

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

Busca em todas as entidades por qualquer combinação de nome, situação, tipo,
jurisdição e data de constituição.

| Campo          | Tipo    | Notas                                                                                                                                                          |
| -------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string  | Opcional. Palavras do nome da entidade. Todas devem coincidir; sem stemming.                                                                                   |
| `status`       | string  | Opcional. p. ex. `Good Standing`, `Delinquent`, `Voluntarily Dissolved`, `Administratively Dissolved`, `Withdrawn`, `Noncompliant`. Não diferencia maiúsculas. |
| `entity_type`  | string  | Opcional. O tipo de entidade como o registro o escreve, p. ex. `Limited Liability Company`.                                                                    |
| `jurisdiction` | string  | Opcional. Onde a entidade foi constituída, p. ex. `CO`, `DE`.                                                                                                  |
| `from_date`    | string  | Opcional. Data mais antiga de constituição, yyyy-mm-dd.                                                                                                        |
| `to_date`      | string  | Opcional. Data mais recente de constituição, 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/colorado-sos/entities-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "acme" }'
```

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

Cada entidade traz `entity_id`, `name`, `status`, `entity_type`, `jurisdiction_of_formation`, `formation_date`, `principal_address` e `mailing_address` (cada um `{ line_1, line_2, city, state, zip, country }` ou null) e `agent` (`{ name, first_name, middle_name, last_name, suffix, organization_name, principal_address, mailing_address }`, ou null).

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

## Uma entidade

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

Resolve uma entidade pelo seu id.

| Campo       | Tipo   | Notas                                          |
| ----------- | ------ | ---------------------------------------------- |
| `entity_id` | string | **Obrigatório.** O id da entidade, só 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" }'
```

Retorna `found`, `entity_id`, `as_of` e `entity` (null quando não encontrado).

Cada entidade traz `entity_id`, `name`, `status`, `entity_type`, `jurisdiction_of_formation`, `formation_date`, `principal_address` e `mailing_address` (cada um `{ line_1, line_2, city, state, zip, country }` ou null) e `agent` (`{ name, first_name, middle_name, last_name, suffix, organization_name, principal_address, mailing_address }`, ou null).

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

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