> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topograph.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Colorado

> Country-specific identifiers, data sources, and integration details

## Start here

This guide contains public integration notes for Colorado. Use it for identifier formats, search behavior, and country-specific caveats. The live source of truth for coverage, pricing, data sources, documents, legal forms, roles, and status values is the pricing page.

<Card title="Colorado coverage, pricing, and sources" icon="arrow-up-right-from-square" href="https://topograph.co/pricing/us-co">
  Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
</Card>

<Warning>
  This jurisdiction may be in preview or limited availability. Check the live pricing page or contact support before relying on it in production.
</Warning>

<Note>
  Country details below are preserved as integration notes. If a table or example conflicts with the live pricing page, use the pricing page as the source of truth and contact support.
</Note>

## Table of Contents

* [Data Sources](#data-sources)
* [Company Identifiers](#company-identifiers)
* [Search Capabilities](#search-capabilities)
* [Quirks & Gotchas](#quirks--gotchas)
* [Mappings](#mappings)
  * [Legal Forms](#legal-forms)
  * [Company Statuses](#company-statuses)
* [Data Availability](#data-availability)

<Warning>
  **API access:** `US-CO` is not yet part of the public `countryCode` enum. Contact us to enable it on your workspace. Requests sent with `countryCode: "US-CO"` will otherwise return `400` until the enum is expanded.
</Warning>

## Data Sources

Colorado uses a single integration against the **Colorado Secretary of State Business Database Search**. The register covers every entity filed with the Secretary of State: corporations, foreign corporations, limited liability companies, nonprofit corporations, limited partnerships, limited liability partnerships, general partnerships, and cooperatives.

* **Colorado Secretary of State business database** (live, authoritative). The public business database exposes legal name, 11-digit entity ID, status, entity form, formation date, jurisdiction, principal office address (street and mailing), and registered agent name and address. Data is read live from the official portal on each request.

<Note>
  **Officers and managers are not filed.** Colorado does not require business entities to file owner, officer, director, member, or manager information with the Secretary of State. That information is kept in the entity records at the principal office. The registered agent is returned as an other key person; `legalRepresentatives` is intentionally empty.
</Note>

## Company Identifiers

### Query Identifiers

| Identifier Type            | Format                  | Example       | Notes                                                                                               |
| -------------------------- | ----------------------- | ------------- | --------------------------------------------------------------------------------------------------- |
| **Colorado SOS Entity ID** | 11 digits, numeric only | `19931121425` | Assigned by the Colorado Secretary of State. The primary identifier for search and profile lookups. |

<Tip>
  The entity ID is 11 digits and purely numeric. Pass it exactly as returned by search. The full list of filing documents for an entity also uses this ID as the primary key.
</Tip>

### Identifiers in API Response

| Identifier | Format                  | Example       | Found In     |
| ---------- | ----------------------- | ------------- | ------------ |
| `entityId` | 11 digits, numeric only | `19931121425` | All entities |

## Search Capabilities

| Search Type  | Pattern     | Example           | Match Type                     | Expected Results                                                       |
| ------------ | ----------- | ----------------- | ------------------------------ | ---------------------------------------------------------------------- |
| By Name      | 2-100 chars | `"Acme Holdings"` | Starts-with (case-insensitive) | Multiple results                                                       |
| By Entity ID | 11 digits   | `19931121425`     | Exact                          | Exact match returned first (`matchType: id`); other results may follow |

<Note>
  Name search anchors on the beginning of the legal name (case-insensitive). Use fuller query strings to narrow the result set, which is capped at 50 matches.
</Note>

## Quirks & Gotchas

| Quirk                                       | Details                                                                                                                                                                                                                                               |
| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Officers and managers are not available** | Colorado law does not require entities to file owner, officer, director, member, or manager information with the Secretary of State. These fields are kept in the entity's own records. `legalRepresentatives` is always empty for Colorado entities. |
| **No shareholder or UBO register**          | Colorado does not publish shareholders or beneficial owners for any entity type. Federal FinCEN BOI records are separate and not publicly accessible.                                                                                                 |
| **Registered agent is an other key person** | The registered agent is surfaced under `otherKeyPersons`, not under `legalRepresentatives`. It receives service of process and has no statutory authority to bind the entity.                                                                         |
| **No bulk dataset**                         | No official bulk business-entity dataset or open data feed was found for Colorado. All data is returned live from the official portal on each request.                                                                                                |
| **No activity codes**                       | Industry classification codes are not published on Colorado Secretary of State business summary records.                                                                                                                                              |
| **Tax ID is separate**                      | The Colorado SOS entity ID is not a tax ID. For federal EIN or Colorado state tax IDs, direct the entity to the IRS or Colorado Department of Revenue.                                                                                                |
| **Free documents are bundled**              | The Trade Register Extract (printed current detail page) and the Formation Filing PDF are included at no extra charge with the company data block.                                                                                                    |

## Mappings

### Legal Forms

Legal form is sourced from the entity-type label shown on the Colorado Secretary of State business database. The vocabulary below covers the entity forms observed in live search results and detail pages.

<AccordionGroup>
  <Accordion title="Colorado entity forms">
    | Colorado Entity Form              | Standardized            |
    | --------------------------------- | ----------------------- |
    | Corporation                       | Corporation             |
    | Foreign Corporation               | Corporation             |
    | Limited Liability Company         | LimitedLiabilityCompany |
    | Foreign Limited Liability Company | LimitedLiabilityCompany |
    | Nonprofit Corporation             | NonprofitOrganization   |
    | Limited Partnership               | Partnership             |
    | Limited Liability Partnership     | Partnership             |
    | General Partnership               | Partnership             |
    | Cooperative                       | Cooperative             |
  </Accordion>
</AccordionGroup>

<Note>
  The list above reflects entity forms observed in the register. Additional or unusual forms may appear; they are returned using the raw label from the register.
</Note>

### Company Statuses

Status values observed in Colorado Secretary of State records:

| Status                     |
| -------------------------- |
| Good Standing              |
| Voluntarily Dissolved      |
| Administratively Dissolved |
| Judicially Dissolved       |
| Delinquent                 |
| Withdrawn                  |
| Expired                    |
| Converted                  |
| Merged                     |

## Data Availability

| Data Point                   | Available | Notes                                                                            |
| ---------------------------- | --------- | -------------------------------------------------------------------------------- |
| Company name                 | Yes       | Current legal name from the register                                             |
| Company status               | Yes       | Live status from the official portal (e.g. Good Standing, Voluntarily Dissolved) |
| Registration date            | Yes       | Formation date as filed with the Secretary of State                              |
| Legal address                | Yes       | Principal office street and mailing address                                      |
| Legal form                   | Yes       | Entity type from the register, mapped to a standardized category                 |
| Legal representatives        | No        | Colorado does not require officer/director/member/manager filings                |
| Registered agent             | Yes       | Name and address, returned as an other key person                                |
| Activity codes               | No        | Not published on Colorado SOS records                                            |
| Shareholders                 | No        | Not published                                                                    |
| UBOs                         | No        | No public beneficial ownership register in Colorado                              |
| Trade Register Extract       | Yes       | Free printed PDF of the current detail page, bundled with company data           |
| Formation Filing             | Yes       | Free PDF of the original formation filing, bundled with company data             |
| Certified copies             | No        | Not yet available through Topograph                                              |
| Certificate of Good Standing | No        | Not yet available through Topograph                                              |
| Financial data               | No        | Not collected                                                                    |

## Example API Responses

### Search by Name

```bash theme={null}
curl -X POST "https://api.topograph.co/v2/search?country=US-CO&query=Acme+Holdings" \
  -H "x-api-key: YOUR_API_KEY"
```

```json theme={null}
[
  {
    "id": "20241234567",
    "legalName": "ACME HOLDINGS LLC",
    "countryCode": "US-CO",
    "matchReason": {
      "matchType": "default"
    },
    "address": {
      "region": "CO",
      "countryCode": "US"
    }
  }
]
```

### Search by Entity ID

```bash theme={null}
curl -X POST "https://api.topograph.co/v2/search?country=US-CO&query=20241234567" \
  -H "x-api-key: YOUR_API_KEY"
```

```json theme={null}
[
  {
    "id": "20241234567",
    "legalName": "ACME HOLDINGS LLC",
    "countryCode": "US-CO",
    "matchReason": {
      "matchType": "id"
    }
  }
]
```

### Company Profile

```bash theme={null}
curl -X POST "https://api.topograph.co/v2/company" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"countryCode": "US-CO", "id": "20241234567", "dataPoints": ["company", "otherKeyPersons"]}'
```

```json theme={null}
{
  "company": {
    "id": "20241234567",
    "countryCode": "US-CO",
    "identifiers": { "entityId": "20241234567" },
    "legalName": "ACME HOLDINGS LLC",
    "status": "Good Standing",
    "registrationDate": "2024-03-15",
    "legalForm": {
      "localName": "Limited Liability Company",
      "standardized": "LimitedLiabilityCompany"
    },
    "legalAddress": {
      "street": "123 Main Street",
      "city": "Denver",
      "region": "CO",
      "postalCode": "80202",
      "countryCode": "US"
    }
  },
  "legalRepresentatives": [],
  "otherKeyPersons": [
    {
      "firstName": "Jane",
      "lastName": "Smith",
      "role": "Registered Agent",
      "address": {
        "street": "456 Oak Avenue",
        "city": "Denver",
        "region": "CO",
        "postalCode": "80203",
        "countryCode": "US"
      }
    }
  ]
}
```