# New Business Filings: Colorado and New York Companies (`ledgerstar/state-business-filings`) Actor

Newly formed LLCs, corporations and nonprofits from Colorado and New York Secretary of State registries. Filter by date, entity type, city. Records include business name, formation date and status. Colorado adds address and ZIP. Ready for accountants targeting new filers and sales teams.

- **URL**: https://apify.com/ledgerstar/state-business-filings.md
- **Developed by:** [Ledger Star](https://apify.com/ledgerstar) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$4.00 / 1,000 results

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

## New Business Filings: Colorado and New York Companies

Every week thousands of companies form in Colorado and New York. This Actor turns the official Secretary of State registries into ready-to-use leads: business name, formation date, entity type and location (Colorado only), filtered to your date range and industry.

### What you get

- Fresh volume: Colorado Secretary of State issued between 3,130 and 3,721 new business entities per week over the four complete weeks ending September 14, 2026. New York Department of State issued between 4,511 and 5,297 per week in the same period. The count varies week to week.
- Each record has business name, entity type, formation date, status and county. Colorado records include address, city and ZIP. New York records include county only; New York's registry publishes no business-location address field, so city and ZIP are always null.
- Filters for date, entity type, city and ZIP, plus an alert mode that returns only filings you have not seen yet.

### Quick start

1. Choose one or both states: Colorado, New York, then a date range (last N days or exact start date).
2. Add optional filters: entity types, cities (Colorado only), ZIP prefixes (Colorado only), and a result limit.
3. Click Start, then export the results.

**Worked example:** Colorado, entity type LLC, formed in the last 7 days. Between September 19 and 26, 2026, Colorado recorded 3,052 new LLCs, so the full list would cost $12.21 at $0.004 each. Set maximum results to 100 to sample the newest 100 for $0.40. Your count will differ week to week.

### Who uses it

- **Accountants and bookkeepers:** target new LLCs and corporations needing EINs, bookkeeping and tax returns in your area.

- **Banks, insurance, payroll and software sales:** new entities buy bank accounts, insurance and payroll services. Filter by territory and sync to your CRM.

- **Market research:** track formations by state, type and week from official data sources.

### Sample output

Example rows showing the format:

| Formed | State | Entity | Type | Status |
|---|---|---|---|---|
| 2026-09-19 | CO | Mountain Peak Consulting LLC | DLLC | Good Standing |
| 2026-09-20 | NY | TechStart Solutions Inc | BUSINESS CORPORATION | Active |
| 2026-09-21 | CO | Solar Energy Partners LLC | LLC | Good Standing |

<details><summary>Full JSON example</summary>

```json
{
  "state": "CO",
  "registryId": "20261000037",
  "name": "Mountain Peak Consulting LLC",
  "entityType": "DLLC",
  "entityCategory": "LLC",
  "status": "Good Standing",
  "formationDate": "2026-09-19",
  "jurisdiction": "Colorado",
  "county": null,
  "address": "1013 Pearl Street",
  "city": "Boulder",
  "addressState": "CO",
  "zip": "80301",
  "country": "US",
  "source": "Colorado Secretary of State — Business Entities (Colorado Information Marketplace)",
  "sourceUrl": "https://data.colorado.gov/Business/Business-Entities-in-Colorado/4ykn-tg5h",
  "scrapedAt": "2026-09-25T14:00:00.000Z"
}
```

</details>

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| States | array | Both | Colorado, New York. |
| Formed in the last N days | integer | 30 | Look back N days from today. |
| Formed on or after | date | none | Exact start date (YYYY-MM-DD). |
| Entity types | array | none | LLC, Corporation, Nonprofit, Partnership, Other. |
| Maximum results | integer | 20 | Results to return. You pay per result. |

<details><summary>Advanced options</summary>

- **Home-state entities only** (boolean, default false): Skip foreign entities. Colorado only.
- **Cities** (array, optional): Principal-office city, exact match. Colorado only.
- **ZIP codes or ZIP prefixes** (array, optional): Full ZIP or prefix. Colorado only.
- **Maximum source rows to scan per state** (integer, default 20000): Safety cap per run.
- **Socrata app token** (string, optional): Free token from state portal for higher rate limits.
- **Alert mode: stable state name** (string, optional): Fixed name for alert mode store (e.g., co-nightly). Letters, numbers, hyphens only, max 30 characters.
- **Alert mode: only filings new since** (string, optional): Date (YYYY-MM-DD) or lastRun for alert mode.
- **Alert mode: lookback safety window in days** (integer, default 7, max 30): Days to check before last run for late-posted filings.

</details>

### Alert mode: only new records

Run on a schedule and get only entities formed since your last run. The first run returns normal results; later runs return only new filings. You pay only for new results.

Set it up:

1. Create a Task in Apify Console with your filters.
2. Set "Alert mode: only filings new since" to lastRun.
3. Go to the Task Schedule tab and add a daily or weekly schedule.

Keep your filters the same on every run. See the FAQ for how alert mode works.

### Pricing

$4.00 per 1,000 results ($0.004 per entity).

Worked examples: 100 results cost $0.40, 1,000 results cost $4.00, and 10,000 results cost $40.00. Set a maximum cost per run and the Actor stops cleanly at your budget.

### Integrations

- **Google Sheets:** send every run's results to a sheet automatically.
- **Zapier and Make:** trigger a workflow for each new filing, for example add it to your CRM.
- **Slack:** post a message when a run finds new entities.
- **Apify API:** download results as CSV, Excel or JSON from your own code.
- **Export:** CSV, Excel and JSON downloads straight from the dataset view.

### Data source and compliance

Official open data from the Colorado Secretary of State and New York Department of State, read through their public APIs. Only registered business entities are returned. The Actor never returns personal names, phone numbers or details such as registered agent names.

Formation dates and business locations are public records. Use the data for legitimate business outreach and follow applicable anti-spam and privacy laws. Not affiliated with either state government.

### FAQ

**How current is the data?**
Each run queries the live datasets, so results are as current as each state's latest update.

**Why do New York rows have no address, city or ZIP?**
New York's registry publishes a service-of-process address only, which can belong to a person. We never output it to protect privacy.

**What entity types are included?**
LLC, Corporation, Nonprofit, Partnership, and other types the state's registry contains. Sole proprietors are not returned.

**How does alert mode remember which filings to skip?**
Filings are marked new if formed on or after the previous run date. The Actor saves your last run time and delivered entity IDs in a named store (alert-state-business-filings-{code}) and checks it on each run to skip duplicates.

**Can I schedule this?**
Yes. Create a Task with your filters in Apify Console, set alert mode to lastRun, and add a daily or weekly schedule.

**Can I use this for cold outreach?**
Yes, within CAN-SPAM and TCPA rules. This is public business data, so contact the business, never a personal residence.

### More from Ledgerstar

- **Texas New Business Leads:** Texas sales tax permits data: https://apify.com/ledgerstar/texas-sales-tax-permits

- **Nonprofit Finder:** IRS Exempt Organizations by state: https://apify.com/ledgerstar/nonprofit-finder

- **Chamber of Commerce Directory Scraper:** Local Chamber of Commerce business lists: https://apify.com/ledgerstar/chamber-directory-scraper

- **Building Permits Leads:** new construction and contractor permits across several cities (arriving on the Store soon)

### Support

Support: open an issue on this Actor's Issues tab in Apify Console.

# Actor input Schema

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

Registries to search. Results are split evenly across the selected states.

## `daysBack` (type: `integer`):

Look back this many days from today. Ignored when 'Formed on or after' is set.

## `filedSince` (type: `string`):

Exact start date (YYYY-MM-DD). Overrides 'last N days'.

## `newSince` (type: `string`):

Turns on alert mode: only return filings formed on or after this date. Use an exact date (YYYY-MM-DD) or the word lastRun to return only filings formed since the previous successful run. Leave empty to turn alert mode off and use the settings above instead.

## `alertLookbackDays` (type: `integer`):

Only used with newSince set to lastRun. Widens the check to this many days before the previous run's start, so a filing the source posts a few days late is still delivered. You are never charged twice for the same filing. Default 7, minimum 1, maximum 30.

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

Leave empty for all types.

## `domesticOnly` (type: `boolean`):

Skip out-of-state (foreign) entities that registered to do business in the state.

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

Principal-office city, e.g. Denver, Boulder. Case-insensitive, exact city name. Colorado only — New York's registry publishes no business-location city field, so this filter has no effect on NY results.

## `zipPrefixes` (type: `array`):

e.g. 80202 or 802 (Denver). Colorado only — New York's registry publishes no business-location ZIP field, so NY results are never matched by this filter.

## `maxItems` (type: `integer`):

Stop after this many results in total. You are charged per result.

## `maxRowsScannedPerState` (type: `integer`):

Safety limit on raw rows read while filtering (one request per second).

## `appToken` (type: `string`):

Optional free app token for higher rate limits on very large pulls. Not needed for normal use.

## `alertStateKey` (type: `string`):

Only used with alert mode (the field above). Give this a fixed name such as co ny nightly so this schedule always uses the same saved last run date, even if you change other filters. Letters, numbers and hyphens only, up to 30 characters. Leave empty to have one chosen automatically based on your filters.

## Actor input object example

```json
{
  "states": [
    "CO",
    "NY"
  ],
  "daysBack": 30,
  "alertLookbackDays": 7,
  "domesticOnly": false,
  "maxItems": 20,
  "maxRowsScannedPerState": 20000
}
```

# Actor output Schema

## `results` (type: `string`):

No description

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

No description

## `output` (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",
        "NY"
    ],
    "daysBack": 30,
    "alertLookbackDays": 7,
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("ledgerstar/state-business-filings").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",
        "NY",
    ],
    "daysBack": 30,
    "alertLookbackDays": 7,
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("ledgerstar/state-business-filings").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",
    "NY"
  ],
  "daysBack": 30,
  "alertLookbackDays": 7,
  "maxItems": 20
}' |
apify call ledgerstar/state-business-filings --silent --output-dataset

```

## MCP server setup

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

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/qfRoCbFcp1E72gr4F/builds/BzgT1u2Em47QTqpXY/openapi.json