# US State Business Entity Registry API (Unofficial) (`graylabs/us-state-business-entities`) Actor

Search registered businesses in Colorado, Connecticut and New York: entity ID, name, type, status, formation date, city, ZIP. Filter by name, date, city, ZIP or category. Public open data, no API key. No agents, officers, contact data or sole proprietors. Not affiliated with any state agency.

- **URL**: https://apify.com/graylabs/us-state-business-entities.md
- **Developed by:** [Gray Labs](https://apify.com/graylabs) (community)
- **Categories:** Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 business entities

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## US State Business Entity Registry API (Unofficial)

Search **registered businesses in Colorado, Connecticut and New York** and download them as JSON, CSV or Excel, or read them through the Apify API. No account or API key is needed.

- **Search by** entity name, formation date, city, ZIP code, entity category (LLC, corporation, nonprofit, partnership, cooperative) and status, in one or more states at once.
- **Look up by ID:** Colorado entity IDs, Connecticut account numbers or New York DOS IDs, up to 1,000 per run.
- **Follow new registrations:** set `formedFrom` and sort by newest. All three registries are updated daily (CO, CT) or regularly (NY).
- **Per row:** registry state, entity ID, name, entity type and category, domestic or foreign, jurisdiction of formation, status, active flag, formation date, city, state and ZIP of the business address, plus NAICS code, dissolution date and annual report due date where Connecticut publishes them.

Good for know-your-business checks, verifying that a company exists and is in good standing, market sizing, new-business statistics by city or industry, and enriching your own company lists with registry IDs.

The data comes from three state open-data portals, read through their keyless public APIs: the Colorado Department of State's business entity dataset on data.colorado.gov, the Connecticut Secretary of the State's business registry on data.ct.gov, and the New York Department of State's active corporations dataset on data.ny.gov.

**Entity data only.** No registered agents, officers, CEOs, owners or other people's names, no email addresses or phone numbers, and no street addresses. Corporations sole, name reservations and other single-person or non-entity records are withheld.

### What data can you extract?

| Field                                                                                 | Meaning                                                                                                                                                      |
| ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `state`, `entityId`, `name`                                                           | Registry (CO, CT, NY), the registry's ID and the registered name                                                                                             |
| `entityType`, `entityCategory`                                                        | Entity type as published (e.g. DLLC, LLC, DOMESTIC BUSINESS CORPORATION) and a broad category (llc, corporation, nonprofit, partnership, cooperative, other) |
| `domestic`, `jurisdictionOfFormation`                                                 | Formed in this state or registered from elsewhere, and where it was formed                                                                                   |
| `status`, `active`, `subStatus`                                                       | Status as published (e.g. Good Standing, Delinquent, Active, Dissolved) and whether the entity currently exists                                              |
| `formationDate`, `dissolutionDate`, `annualReportDueDate`                             | Formation or registration date; Connecticut dissolution and annual report due dates                                                                          |
| `naicsCode`, `naicsDescription`, `totalAuthorizedShares`                              | Connecticut only: industry code reported by the business and authorized shares                                                                               |
| `city`, `businessState`, `zip`, `country`, `county`                                   | City, state and 5-digit ZIP of the business address (no street); New York county                                                                             |
| `sourceDataset`, `sourceRecordUrl`, `licence`, `attribution`, `notice`, `retrievedAt` | Source dataset page, an API link to the source record, licence or terms, attribution, a non-affiliation line, fetch time                                     |

### How to use it

1. Click **Try for free** and keep the prefilled input (the 20 newest active registrations across CO, CT and NY), or set your own filters.
2. Run it. Rows appear in the **Output** tab.
3. With several states, `maxResults` is shared evenly between them; room one state does not use goes to the next.

### Input examples

New LLCs registered this month in all three states:

```json
{
    "states": ["CO", "CT", "NY"],
    "entityCategories": ["llc"],
    "formedFrom": "2026-10-01",
    "sort": "newest",
    "maxResults": 300
}
```

Bakeries in Denver and New Haven, including closed ones:

```json
{
    "states": ["CO", "CT"],
    "name": "bakery",
    "cities": ["Denver", "New Haven"],
    "status": "any",
    "maxResults": 200
}
```

Look up entities by ID:

```json
{
    "states": ["CO", "CT", "NY"],
    "entityIds": ["20268309909", "3539826", "8055241"],
    "status": "any"
}
```

### Output example

```json
{
    "state": "CT",
    "entityId": "3539826",
    "name": "Smartbuys LLC",
    "entityType": "LLC",
    "entityCategory": "llc",
    "domestic": true,
    "jurisdictionOfFormation": "Connecticut",
    "status": "Active",
    "active": true,
    "subStatus": null,
    "formationDate": "2026-10-25",
    "dissolutionDate": null,
    "annualReportDueDate": "2027-03-31",
    "naicsCode": "455219",
    "naicsDescription": "All Other General Merchandise Retailers",
    "totalAuthorizedShares": null,
    "city": "Waterbury",
    "businessState": "CT",
    "zip": "06710",
    "country": "United States",
    "county": null,
    "sourceDataset": "https://data.ct.gov/d/n7gp-d28j",
    "sourceRecordUrl": "https://data.ct.gov/resource/n7gp-d28j.json?accountnumber=3539826",
    "licence": "Public Domain (dataset licence on data.ct.gov); Connecticut Open Data Portal Terms of Use apply.",
    "attribution": "Source: Connecticut Secretary of the State, Business Services Division, \"Connecticut Business Registry - Business Master\" (https://data.ct.gov/d/n7gp-d28j), Public Domain, provided \"as is\" without warranty. Changed by this Actor: fields selected and renamed; email, mailing and street address fields, owner characteristics and name reservations removed.",
    "notice": "Unofficial. Not affiliated with or endorsed by the Colorado Department of State, the Connecticut Secretary of the State or the New York Department of State.",
    "retrievedAt": "2026-10-26T13:36:34.458Z"
}
```

### How much does it cost?

- **$0.01 per run start** plus **$2 per 1,000 entities saved** ($0.002 each, the `entity` event). Example: 1,000 entities = $0.01 + $2 = $2.01.
- You pay only for rows that are saved. Withheld, filtered and duplicate records are free.
- Set **Maximum cost per run** when you start a run; the Actor stops cleanly when it reaches your cap. The minimum is $0.05, enough for 20 entities.

### Privacy: entity data only

- **No people.** Registered agent names and addresses (CO), CEO, registered agent and service-of-process names and addresses (NY) are never requested from the source: every request lists only the columns this Actor outputs.
- **No contact details.** Connecticut's business email addresses are never requested. No phone numbers exist in these datasets.
- **No street addresses.** Only city, state and 5-digit ZIP of the business address are returned. Many small businesses register at a home address, so street lines, suites, mailing addresses and records addresses are never requested.
- **No ZIP code where the entity is likely one or a few people:** general partnerships, limited liability partnerships and professional service corporations or LLCs.
- **Entities named after a person are left out entirely**, e.g. "JOHN SMITH LLC" or "JANE DOE, M.D., P.C.". The name check is a heuristic and errs on the side of leaving rows out; withheld rows are free.
- **Also withheld entirely:** corporations sole (an office held by one person), Connecticut name reservations and rejected filings, New York name reservations and designations, and any entity type this Actor does not recognise.
- **No owner characteristics.** Connecticut's woman-, veteran-, minority-, disability- and LGBTQI-owned flags and map coordinates are never requested.
- Name searches match the entity's own registered name only.

### Limits

- **Three states:** Colorado, Connecticut and New York. Other states do not publish their registries as keyless open data.
- **New York lists active entities only** (the dataset is a monthly snapshot of active corporations, LLCs and partnerships), so `status` = `any` adds inactive entities for CO and CT only.
- **Up to 100,000 entities per run** (`maxResults` maximum). For more, split the work by date range or state.
- **Name and city filters are exact-text matches** on what the registry published. City names vary in spelling (e.g. "SanDimas"), so check a few spellings for complete results.
- Entity categories are derived by this Actor from each registry's type codes. Colorado sometimes appends the status to the name (e.g. "…, Delinquent August 1, 2025"); names are returned as published.
- Requests are paced at one per second (the portals' crawl delay), with up to 1,000 records each, so 10,000 entities take well under a minute.

### FAQ

**Do I need an API key?** No. The three open-data APIs are keyless.

**How fresh is the data?** Colorado and Connecticut update their datasets daily; New York publishes a monthly snapshot. Each row has `retrievedAt`, and `sourceRecordUrl` returns the record straight from the source.

**Can I get officers, owners or registered agents?** No. This Actor returns entity data only, by design.

**Why is the ZIP code empty for some rows?** The entity is a partnership or professional firm, or its name looks like a person's name. See Privacy.

**Is this the state's own service?** No. This is an independent tool that reads public open data. Unofficial. Not affiliated with or endorsed by the Colorado Department of State, the Connecticut Secretary of the State or the New York Department of State.

### Data sources and licences

- **Colorado:** "Business Entities in Colorado" (https://data.colorado.gov/d/4ykn-tg5h), Colorado Department of State, published on the Colorado Information Marketplace. Licence: Public Domain (dataset metadata). The State of Colorado Terms of Service (https://data.colorado.gov/terms) ask applications using the data to include this disclaimer:

  > The data made available here has been modified for use from its original source, which is the State of Colorado. THE STATE OF COLORADO MAKES NO REPRESENTATIONS OR WARRANTY AS TO THE COMPLETENESS, ACCURACY, TIMELINESS, OR CONTENT OF ANY DATA MADE AVAILABLE THROUGH THIS SITE. THE STATE OF COLORADO EXPRESSLY DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. The data is subject to change as modifications and updates are complete. It is understood that the information contained in the Web feed is being used at one's own risk.

- **Connecticut:** "Connecticut Business Registry - Business Master" (https://data.ct.gov/d/n7gp-d28j), Office of the Secretary of the State, Business Services Division, published on the Connecticut Open Data Portal. Licence: Public Domain (dataset metadata). Provided "as is" under the portal's Terms of Use (https://data.ct.gov/terms); the State makes no warranty as to accuracy, completeness or timeliness.

- **New York:** "Active Corporations: Beginning 1800" (https://data.ny.gov/d/n9v6-gdp6), New York State Department of State, Division of Corporations, published on data.ny.gov under the OPEN-NY Terms of Use (https://data.ny.gov/download/77gx-ii52/application/pdf). The dataset states no separate licence.

- **New York terms:** NY data is used under the OPEN-NY Terms of Use; if the State revokes access, NY will be dropped.

This Actor selects and renames fields and removes person, contact and street-address data; it does not change the remaining values. Unofficial. Not affiliated with or endorsed by the Colorado Department of State, the Connecticut Secretary of the State or the New York Department of State.

# Changelog

This Actor's version history is a separate document: https://apify.com/graylabs/us-state-business-entities/changelog.md

# Actor input Schema

## `states` (type: `array`):

Registries to search: CO (Colorado), CT (Connecticut), NY (New York, active entities only). maxResults is shared evenly between the states; room one state does not use goes to the next.

## `name` (type: `string`):

Optional. Words in the registered entity name, e.g. 'bakery'. Case-insensitive. Only the entity's own name is searched.

## `entityIds` (type: `array`):

Optional. Look up specific entities: Colorado entity IDs, Connecticut account numbers or New York DOS IDs (up to 1,000). Each ID is looked up in every selected state. Other filters are ignored in this mode, except status.

## `entityCategories` (type: `array`):

Optional. llc, corporation, nonprofit, partnership, cooperative or other. Default: all.

## `formedFrom` (type: `string`):

Optional. Earliest formation or registration date (YYYY-MM-DD). Use it with sort = newest to follow new registrations.

## `formedTo` (type: `string`):

Optional. Latest formation or registration date (YYYY-MM-DD).

## `cities` (type: `array`):

Optional. City of the business address, exact name, e.g. Denver, New Haven, Brooklyn. Case-insensitive.

## `zipCodes` (type: `array`):

Optional. 5-digit ZIP codes of the business address, e.g. 80202.

## `status` (type: `string`):

Active (default): only entities that currently exist (CO: Good Standing, Exists, Delinquent, Noncompliant; CT: Active, Recorded, Registered). Any: include dissolved, withdrawn, merged and other inactive entities (CO and CT only; the New York dataset lists active entities only).

## `sort` (type: `string`):

Newest formation date first (default), oldest first, or by name.

## `maxResults` (type: `integer`):

Stop after saving this many entities (each saved entity is one charged result).

## `maxRequests` (type: `integer`):

Safety cap on requests to the sources (each returns up to 1,000 records).

## Actor input object example

```json
{
  "states": [
    "CO",
    "CT",
    "NY"
  ],
  "entityIds": [],
  "entityCategories": [],
  "cities": [],
  "zipCodes": [],
  "status": "active",
  "sort": "newest",
  "maxResults": 20,
  "maxRequests": 500
}
```

# Actor output Schema

## `entities` (type: `string`):

No description

## `runSummary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "states": [
        "CO",
        "CT",
        "NY"
    ],
    "maxResults": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("graylabs/us-state-business-entities").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "states": [
        "CO",
        "CT",
        "NY",
    ],
    "maxResults": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("graylabs/us-state-business-entities").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "states": [
    "CO",
    "CT",
    "NY"
  ],
  "maxResults": 20
}' |
apify call graylabs/us-state-business-entities --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,graylabs/us-state-business-entities"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/KH1IOatoGm4O50kb2/builds/1fX2dZ6DH1YGSDGuA/openapi.json