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

# Colorado Business Entities

> Every business entity ever on file with the Colorado Secretary of State, about 3.1 million since 1864, in any status: search by name, status, type, jurisdiction and formation date, and read one entity's addresses and registered agent.

The Colorado Secretary of State keeps the register of every corporation,
limited liability company, nonprofit, partnership and other entity formed in
Colorado or registered to do business there, and keeps it in every status:
in good standing, delinquent, dissolved, withdrawn, merged, converted. For each:
its name and id, status, type, where and when it was formed, its principal and
mailing addresses, and its registered agent with the agent's addresses.
Brought up to date daily.

<Note>
  The whole source, organized and ready to query: every endpoint on this page answers in milliseconds. Every response carries `as_of`: how current the data is. [How datasets work](/datasets).
</Note>

## Search entities

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

Searches every entity by any combination of name, status, type, jurisdiction
and formation date.

| Field          | Type    | Notes                                                                                                                                                   |
| -------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string  | Optional. Words in the entity's name. Every word must match; no stemming.                                                                               |
| `status`       | string  | Optional. e.g. `Good Standing`, `Delinquent`, `Voluntarily Dissolved`, `Administratively Dissolved`, `Withdrawn`, `Noncompliant`. Case does not matter. |
| `entity_type`  | string  | Optional. The entity type as the register writes it, e.g. `Limited Liability Company`.                                                                  |
| `jurisdiction` | string  | Optional. Where the entity was formed, e.g. `CO`, `DE`.                                                                                                 |
| `from_date`    | string  | Optional. The earliest formation date, yyyy-mm-dd.                                                                                                      |
| `to_date`      | string  | Optional. The latest formation date, yyyy-mm-dd.                                                                                                        |
| `page`         | integer | Optional. 1-based page. Default `1`.                                                                                                                    |
| `per_page`     | integer | Optional. Results per page, 1-50. Default `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" }'
```

Returns `as_of`, the applied filters, `total`, `page`, `per_page`, `total_pages`, `count` and `entities[]`, by name.

Every entity carries `entity_id`, `name`, `status`, `entity_type`, `jurisdiction_of_formation`, `formation_date`, `principal_address` and `mailing_address` (each `{ line_1, line_2, city, state, zip, country }` or null) and `agent` (`{ name, first_name, middle_name, last_name, suffix, organization_name, principal_address, mailing_address }`, or null).

Empty fields are `null`. Statuses and types are upper-cased.

## One entity

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

Resolves one entity by its id.

| Field       | Type   | Notes                                       |
| ----------- | ------ | ------------------------------------------- |
| `entity_id` | string | **Required.** The entity's id, digits only. |

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

Returns `found`, `entity_id`, `as_of` and `entity` (null when not found).

Every entity carries `entity_id`, `name`, `status`, `entity_type`, `jurisdiction_of_formation`, `formation_date`, `principal_address` and `mailing_address` (each `{ line_1, line_2, city, state, zip, country }` or null) and `agent` (`{ name, first_name, middle_name, last_name, suffix, organization_name, principal_address, mailing_address }`, or null).

Empty fields are `null`. Statuses and types are upper-cased.

<Card title="Full reference" icon="code" href="/api-reference/overview">
  Schemas, all response fields, and an interactive playground.
</Card>