# Business Entity Search - Secretary of State & LLC Lookup (`sonic_scraper/business-entity-search`) Actor

Business entity search across official Secretary of State registries for Colorado, New York, Pennsylvania, Texas, Oregon and Connecticut: name search, LLC lookup by ID, status, formation date, addresses, registered agent and officers. New business filings for daily lead lists.

- **URL**: https://apify.com/sonic_scraper/business-entity-search.md
- **Developed by:** [Sonic Scraper](https://apify.com/sonic_scraper) (community)
- **Categories:** Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.05 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## Secretary of State Business Entity Search & LLC Lookup

**Business Entity Search** looks up companies in the official Secretary of State business registries of **Colorado, New York, Pennsylvania, Texas, Oregon and Connecticut** in one run. Search by business name, look up entity IDs, or pull every **new LLC and corporation filed** in the last few days for lead lists. Every row has the same clean fields for every state: entity name and ID, type, status, formation date, principal and mailing address, registered agent and, where the state publishes them, officers.

![Business Entity Search output in Apify: state, name, entity ID, type, status, formation date, addresses and links to the official record for Starbucks entities in six states](https://api.apify.com/v2/key-value-stores/lwQu1lCMCLQIIhSMQ/records/business-entity-search-output.png)

*Real output from a default run of Business Entity Search in Apify Console.*

The data comes straight from each state's **official open-data registry** (published by the Secretary of State or the Texas Comptroller), not from scraped search pages, so runs are fast and reliable.

### What can Business Entity Search do?

- 🔎 **Business name search across 6 states**: "contains all words", "starts with" or exact name, for any number of names in one run.
- 🆕 **New business filings**: every LLC, corporation, nonprofit and partnership formed in a date range, newest first. Filter by city, ZIP code or entity type for local lead lists.
- 🪪 **Entity ID lookup**: fetch specific records by state ID (Colorado entity ID, New York DOS ID, Pennsylvania filing number, Texas taxpayer or SOS file number, Oregon registry number, Connecticut business ID).
- 🧾 **KYB and due diligence**: confirm a company exists, its exact legal name, status, formation date, home state and registered agent.
- 🔁 **Monitoring**: turn on *Only entities not returned before*, schedule a daily run, and get only the businesses filed since the last run.
- 📦 **One schema for every state**: JSON, CSV, Excel or API, ready for your CRM, Google Sheets or database.

### Which states are covered?

| State | Official source | Search phrase people use | Data freshness |
|---|---|---|---|
| Colorado | Colorado Secretary of State, Business Entities in Colorado | Colorado business entity search, CO SOS business search | Updated daily |
| New York | NY Department of State, Active Corporations | New York business entity search, NYS corporation search | Updated daily (active entities) |
| Pennsylvania | PA Department of State, Registered Businesses | PA business entity search, Pennsylvania business search | About 1 week behind |
| Texas | Texas Comptroller, Active Franchise Taxpayers | Texas comptroller entity search, TX SOS business search | Updated daily |
| Oregon | Oregon Secretary of State, Active Businesses | Oregon business registry search, Oregon SOS business search | A few days behind |
| Connecticut | CT Secretary of the State, Business Registry | CT business lookup, Connecticut business search | Updated daily |

Want another state? Open an issue on the Issues tab. States are added when they publish an official open-data registry.

### What data do you get?

| Field | Description |
|---|---|
| `state`, `stateName` | Two-letter code and state name |
| `entityId` | The state's ID for the entity |
| `name` | Registered legal name |
| `entityType`, `entityTypeCode` | Type as the state names it (e.g. *Domestic Limited Liability Company*) and its code where the state uses one |
| `category` | Normalized type: `LLC`, `Corporation`, `Nonprofit`, `Partnership` or `Other` |
| `domestic`, `jurisdiction` | Formed in this state or registered as foreign; state of formation |
| `status`, `isActive` | Status as published (e.g. *Good Standing*, *Forfeited*) and a true/false active flag |
| `formationDate` | Formation or registration date (YYYY-MM-DD) |
| `county` | County (New York, Pennsylvania, Texas) |
| `principalAddress`, `mailingAddress` | Street, city, state, ZIP, country |
| `registeredAgentName`, `registeredAgentAddress` | Registered agent (Colorado, New York, Oregon) |
| `people` | Officers, organizers and representatives with their role (Pennsylvania, Oregon, New York) |
| `naics` | Industry code (Connecticut) |
| `officialRecordUrl`, `officialSearchUrl` | Link to the record on the state's website (Colorado, Oregon, Texas) and the state's own search page |
| `sourceDataset`, `sourcePublisher` | The official dataset and agency behind each row |
| `matchedSearchTerm`, `scrapedAt` | Which search found the row, and when |

### How much does it cost?

You pay per entity returned: **$1.50 per 1,000 entities** on the free plan, with automatic volume discounts on paid Apify plans (see the Pricing tab), plus a tiny start fee per run. Searches that find nothing cost only the start fee, and errors are never charged.

- **Check 50 company names across all 6 states** (about 300 rows): about $0.45.
- **Daily new-LLC leads for Denver** (about 30 a day): about $1.40 a month.
- **Every new business filed in Texas last week** (about 10,000): about $15.

Your run's *maximum charge* setting is always respected: the actor stops before it would exceed it and keeps what it collected.

### How to use Business Entity Search

1. Click **Try for free** and open the **Input** tab.
2. Pick **What to do**: search by name, new business filings, or look up IDs.
3. Enter business names (or IDs, or a date range), and choose the states. All six are selected by default.
4. Optionally filter by entity type, city, ZIP code or active status.
5. Click **Start**, then download the results as CSV, Excel or JSON, or read them over the API.

### Input example

New LLCs formed in the last 7 days in Denver and Brooklyn:

```json
{
    "mode": "newFilings",
    "formedWithinDays": 7,
    "states": ["CO", "NY"],
    "categories": ["LLC"],
    "cities": ["Denver", "Brooklyn"],
    "maxResultsPerState": 500
}
```

### Output example

```json
{
    "state": "CO",
    "stateName": "Colorado",
    "entityId": "20268268224",
    "name": "Bell PMRE LLC",
    "entityType": "Domestic Limited Liability Company",
    "entityTypeCode": "DLLC",
    "category": "LLC",
    "domestic": true,
    "jurisdiction": "CO",
    "status": "Good Standing",
    "isActive": true,
    "formationDate": "2026-10-25",
    "county": null,
    "principalAddress": { "street": "4380 E 115th Pl", "city": "Thornton", "state": "CO", "zip": "80233", "country": "US" },
    "mailingAddress": { "street": "11376 Grove St, Unit B", "city": "Westminster", "state": "CO", "zip": "80031", "country": "US" },
    "registeredAgentName": "TONYIA BREE CAMPBELL",
    "registeredAgentAddress": { "street": "11376 Grove St Unit B", "city": "Westminster", "state": "CO", "zip": "80031", "country": "US" },
    "people": [],
    "naics": null,
    "officialRecordUrl": "https://www.coloradosos.gov/biz/BusinessEntityDetail.do?masterFileId=20268268224",
    "officialSearchUrl": "https://www.coloradosos.gov/biz/BusinessEntityCriteriaExt.do",
    "sourceDataset": "https://data.colorado.gov/d/4ykn-tg5h",
    "sourcePublisher": "Colorado Secretary of State",
    "matchedSearchTerm": null,
    "scrapedAt": "2026-11-07T14:12:03.511Z"
}
```

### State-by-state notes

#### Colorado business entity search

Every Colorado entity ever filed (3.1 million), including dissolved and delinquent ones, with registered agent and principal and mailing addresses, plus a link to the record on coloradosos.gov. Use *Active entities only* to drop dissolved entities.

#### New York business entity search (NYS corporation search)

The New York Department of State list of **active** corporations, LLCs, partnerships and nonprofits (4.3 million) with county, DOS process (service of process) address, registered agent and chairman or CEO where filed.

#### Pennsylvania business entity search

All businesses currently registered with the Pennsylvania Department of State (about 2.4 million), with registered office address, county and the officers, organizers and members on the record.

#### Texas comptroller entity search

Every taxpayer set up for Texas franchise tax (3.5 million), from the Texas Comptroller: name, taxpayer number, SOS or COA file number, entity type, right-to-transact status (active, forfeited and so on), county and address. Look up by taxpayer number or by SOS file number.

#### Oregon business registry search

The Oregon Secretary of State list of active businesses, including assumed business names, with principal place of business, mailing address, registered agent and authorized representatives, plus the link to the record on the Oregon business registry.

#### Connecticut business lookup

The Connecticut business registry (1.3 million records): status and sub-status (for example *Annual report due*), formation place, principal office, mailing address and NAICS industry. Name reservations are left out.

### Use with the API

**cURL**

```bash
curl -X POST "https://api.apify.com/v2/acts/sonic_scraper~business-entity-search/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode": "search", "searchTerms": ["acme roofing"], "states": ["TX", "CO"]}'
```

**Python**

```python
from apify_client import ApifyClient

client = ApifyClient("<APIFY_TOKEN>")
run = client.actor("sonic_scraper/business-entity-search").call(run_input={
    "mode": "lookup",
    "entityIds": ["NY:8126668", "TX:32107728928"],
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["state"], item["name"], item["status"], item["formationDate"])
```

**JavaScript**

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

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('sonic_scraper/business-entity-search').call({
    mode: 'newFilings',
    formedWithinDays: 1,
    onlyNew: true,
    stateKey: 'daily-leads',
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`${items.length} new businesses`);
```

### Use with AI agents (MCP)

Add the actor to Claude, Cursor or any MCP client through the Apify MCP server:
`https://mcp.apify.com?tools=sonic_scraper/business-entity-search`

Example prompt: *"Check whether 'Blue Bottle Coffee' is registered in New York and Colorado, and tell me its status and formation date."*

### Integrations

Send results to **Google Sheets**, **HubSpot**, **Make**, **Zapier**, **n8n**, Slack or any **webhook** with Apify integrations. For a daily new-business lead feed: schedule the actor every morning in *New business filings* mode with *Only entities not returned before* on, and connect Google Sheets or your CRM.

### FAQ

#### Which Apify actor searches Secretary of State business registries for LLCs in several states?

Business Entity Search (apify.com/sonic_scraper/business-entity-search) looks up companies in the official registries of Colorado, New York, Pennsylvania, Texas, Oregon and Connecticut in one run. It returns entity name and ID, type, status, formation date, addresses, registered agent and, where published, officers. It costs $1.50 per 1,000 entities on the free plan.

#### How do I search the Secretary of State business database for several states at once?

Enter the business name in *Business names to search*, keep all six states selected and click Start. You get one row per matching entity from each state's official registry, with the same fields for every state, so you can compare or deduplicate them in one spreadsheet.

#### How do I get a list of new LLCs formed this week?

Choose *New business filings*, set *Formed in the last N days* to 7, and optionally pick states, cities, ZIP codes or *LLC* under entity types. Results are sorted newest first. Schedule it daily with *Only entities not returned before* for a running lead list.

#### Where does the data come from, and is it legal to use?

From the official open-data portals of each state (data.colorado.gov, data.ny.gov, data.pa.gov, data.texas.gov, data.oregon.gov, data.ct.gov), published by the Secretary of State or the Texas Comptroller for public reuse. Business registry records are public. If you contact people listed on a record, follow anti-spam and privacy rules (CAN-SPAM, TCPA, state privacy laws).

#### How current is the data?

Colorado, New York, Texas and Connecticut publish updates daily; Oregon is usually a few days behind and Pennsylvania about a week. Each row links to the source dataset, and Colorado, Oregon and Texas rows link to the live record on the state website so you can double-check before you rely on it.

#### Why does New York, Oregon or Pennsylvania only show active entities?

Those states publish their current registry only. Colorado, Texas and Connecticut include dissolved, withdrawn and forfeited entities too; turn on *Active entities only* to hide them.

#### Does it include officers, owners or email addresses?

Officers, organizers and members are included where the state publishes them (Pennsylvania), plus Oregon authorized representatives and New York chairmen or CEOs. Owners of LLCs are not public in most states. Email addresses are not included.

#### Why did I get fewer results than I asked for?

The registry had no more matches, your filters removed them, *Only entities not returned before* skipped entities delivered earlier, or your maximum charge was reached. The `SUMMARY` record shows the count per state, and `ERRORS` lists any state or ID that failed (never billed).

### Related actors

- [SEC Form D Filings](https://apify.com/sonic_scraper/sec-form-d-filings): recently funded companies from SEC Form D: amount raised, investors, industry and executives.
- [UK New Companies](https://apify.com/sonic_scraper/uk-new-companies): newly incorporated UK companies from Companies House by industry and postcode, with directors.
- [Insider Trading Tracker](https://apify.com/sonic_scraper/sec-insider-trading-tracker): SEC Form 4 insider buys and sells.
- [Contact Details Scraper](https://apify.com/sonic_scraper/b2b-website-intelligence-scraper): emails, phones and tech stack from company websites.
- [Google Maps Email Extractor](https://apify.com/sonic_scraper/google-maps-lead-enricher): enrich local business leads with emails.
- [Job Scraper](https://apify.com/sonic_scraper/multi-job-board-scraper): hiring signals from LinkedIn and Indeed.

# Actor input Schema

## `mode` (type: `string`):

<b>Search</b> finds entities by name. <b>New business filings</b> lists entities formed in a date range, newest first (great for leads). <b>Lookup</b> fetches specific entity IDs.

## `searchTerms` (type: `array`):

Company names or parts of names, e.g. <code>acme roofing</code>. Used in search mode. Each term is searched in every selected state.

## `matchType` (type: `string`):

How the name must match. 'Contains all words' finds 'Starbucks Coffee Company' for 'starbucks coffee'.

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

Used in lookup mode. Format <code>STATE:ID</code>: <code>CO:20268371355</code> (Colorado entity ID), <code>NY:8126668</code> (DOS ID), <code>PA:0016040963</code> (filing number), <code>TX:32107728928</code> (taxpayer number or SOS file number), <code>OR:264329690</code> (registry number), <code>CT:3161375</code> (business ID).

## `formedWithinDays` (type: `integer`):

New business filings mode: entities formed in the last N days. Ignored when 'Formed on or after' is set.

## `formedAfter` (type: `string`):

New business filings mode: start date (YYYY-MM-DD).

## `formedBefore` (type: `string`):

New business filings mode: end date (YYYY-MM-DD). Default: today.

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

Which state registries to search. All six by default.

## `categories` (type: `array`):

Keep only these types. Empty = all.

## `activeOnly` (type: `boolean`):

Drop dissolved, withdrawn, revoked and forfeited entities (Colorado, Connecticut and Texas include them; the New York, Pennsylvania and Oregon registries list current entities only).

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

Keep entities whose principal or mailing address is in one of these cities, e.g. <code>Denver</code>.

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

Keep entities whose address ZIP starts with one of these, e.g. <code>802</code> or <code>10001</code>.

## `includePeople` (type: `boolean`):

Add the people listed on the record where the state publishes them: Pennsylvania officers and organizers, Oregon authorized representatives, New York chairman/CEO.

## `maxResultsPerState` (type: `integer`):

Upper limit of entities from each state (per search term in search mode).

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

Upper limit for the whole run. Your run's maximum charge is also respected.

## `onlyNew` (type: `boolean`):

Monitoring: skip entities earlier runs with the same state key already returned (and never bill them again). Combine with new business filings mode and a daily schedule.

## `stateKey` (type: `string`):

Name of the memory used by 'Only entities not returned before'. Use a different key per schedule.

## `socrataAppToken` (type: `string`):

Optional free app token from any Socrata open-data portal for higher rate limits on very large runs. Not needed for normal use.

## Actor input object example

```json
{
  "mode": "search",
  "searchTerms": [
    "starbucks"
  ],
  "matchType": "contains",
  "formedWithinDays": 7,
  "states": [
    "CO",
    "NY",
    "PA",
    "TX",
    "OR",
    "CT"
  ],
  "activeOnly": false,
  "includePeople": true,
  "maxResultsPerState": 10,
  "maxResults": 1000,
  "onlyNew": false,
  "stateKey": "default"
}
```

# Actor output Schema

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

One row per entity, same fields for every state.

## `leads` (type: `string`):

Formation date, address and people, for new-filing lead lists.

## `summary` (type: `string`):

Counts per state and type, registry rows read and run statistics.

## `errors` (type: `string`):

States or IDs that could not be read. Only present when something failed; never billed.

# 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 = {
    "mode": "search",
    "searchTerms": [
        "starbucks"
    ],
    "states": [
        "CO",
        "NY",
        "PA",
        "TX",
        "OR",
        "CT"
    ],
    "maxResultsPerState": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("sonic_scraper/business-entity-search").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 = {
    "mode": "search",
    "searchTerms": ["starbucks"],
    "states": [
        "CO",
        "NY",
        "PA",
        "TX",
        "OR",
        "CT",
    ],
    "maxResultsPerState": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("sonic_scraper/business-entity-search").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 '{
  "mode": "search",
  "searchTerms": [
    "starbucks"
  ],
  "states": [
    "CO",
    "NY",
    "PA",
    "TX",
    "OR",
    "CT"
  ],
  "maxResultsPerState": 10
}' |
apify call sonic_scraper/business-entity-search --silent --output-dataset

```

## MCP server setup

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

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/S6uBQNwk2B2ttOy9m/builds/ANLwd7rYKyhm7f1ov/openapi.json
