# Secretary of State Business Search: KYB, Agents, Officers (`themineworks/secretary-of-state-business-search`) Actor

Search US Secretary of State business registries by name or entity number in NY, CO, CT, OR, PA, TX and ID: legal name, entity number, type, status, formation date, addresses, registered agent, officers and annual reports where published. No login.

- **URL**: https://apify.com/themineworks/secretary-of-state-business-search.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** Lead generation, Business, 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.08 / 1,000 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 Search: KYB, Agents, Officers

[![US business entities from seven Secretary of State registries, one row per entity](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/secretary-of-state-business-search-hero.png)](https://console.apify.com/actors/JgicSP3pI5yMT7Z13/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

From **The Mine Works**, makers of [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) and [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), with over 290,000 runs across 310+ public actors.

Updated 27 Oct 2026: first release. Business names or entity numbers in; one flat row per US business entity out, with legal name, entity number, type, status, formation date, state of formation, principal and mailing address, registered agent, officers where the state publishes them, annual report dates and filing history. Seven states: New York, Colorado, Connecticut, Oregon, Pennsylvania, Texas and Idaho. Bookmark this Actor on its Store page so it is one click away next time.

### Why choose this actor?

- **One name in, one verified entity per state out.** Clay, n8n and AI agents call it with one business name and get the best match in each state, ranked by `name_match_score`, with `exact_name_match` and `is_active` ready to branch on. Batches of up to 5,000 lines work the same way, and every row carries `input_index` to join it back to your list.
- **Read from the state, not a copy of a copy.** Every row comes from the Secretary of State's own open data or its own record API, names its `source`, links the official search in `source_url` and says what the source covers in `data_scope` (for example "Active entities only"), so a reviewer knows exactly what a match means.
- **Agents, officers and reports in the same row.** Registered agent with address in NY, CO, CT, OR and ID, officers with titles in CT, PA, OR and NY (where filed), the date of the latest annual report in NY, CO and CT, the next report due date in CT and ID, and the filing history in NY, CO and CT. No account, no API key, no CAPTCHA.

[![Run it on Apify](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/JgicSP3pI5yMT7Z13/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Part of The Mine Works Company and business data family:** [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [EU VAT Checker (VIES)](https://apify.com/themineworks/eu-vat-vies-validator?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Tech Stack Detector](https://apify.com/themineworks/tech-stack-detector?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

### Try it in one minute

Paste this into the input (JSON view) and press Start. It searches two names in all seven states and looks up one Colorado entity number. It took 20 seconds in our test run (up to 90 seconds when a state portal answers slowly):

```json
{
  "searches": ["Tesla, Inc.", "Dell Inc.", "CO: 20091632423"]
}
```

Put one name or number per line. A state code in front (`TX: Dell Inc.`) searches that state only.

Apify's free plan includes $5 of credit every month, which covers about 2,700 entities at this actor's price.

#### Copy to your AI assistant

```text
themineworks/secretary-of-state-business-search on Apify. Searches US Secretary of State business registries (New York, Colorado, Connecticut, Oregon, Pennsylvania, Texas, Idaho) by business name or entity number and returns one flat row per entity, with no login. Call ApifyClient("TOKEN").actor("themineworks/secretary-of-state-business-search").call(run_input={"searches": ["Tesla, Inc.", "TX: Dell Inc."], "maxResultsPerState": 1}), then client.dataset(run["defaultDatasetId"]).list_items().items. searches is a list (up to 5000) of business names or entity numbers; a two letter state code in front ("TX: Dell Inc.", "NY | 1679154") limits that line to one state. Optional: states (list of NY, CO, CT, OR, PA, TX, ID; default all), maxResultsPerState (default 3; 1 returns the best match per state), exactMatch (default false), minNameMatchScore (default 0.5), activeOnly (default false), includeFilingHistory (default true), maxFilingsPerEntity (default 25). Entity rows have no _type field and carry entity_name, entity_number, state, entity_type, entity_type_family, status, status_detail, is_active, formation_date, state_of_formation, domestic_or_foreign, principal_address, principal_street, principal_city, principal_state, principal_zip, mailing_address, county, registered_agent_name, registered_agent_address, service_of_process_name, service_of_process_address, officers (name, title, address), officers_count, annual_report_due_date, last_annual_report_date, annual_reports (date, type, year), filing_history (date, type, description, effective_date), filings_count, business_email, naics_code, naics_description, other_ids, source, source_url, data_scope, search_query, input_index, match_type, name_match_score, exact_name_match, matched_name, search_rank, search_matches, scraped_at. Each run also writes one row with _type "summary" (with by_state counts), one with _type "info" when entities were delivered, and a row with _type "error" for each line that found nothing; none of these is charged. Full spec: GET https://api.apify.com/v2/acts/themineworks~secretary-of-state-business-search/builds/default (Bearer TOKEN), which returns inputSchema and readme. Token: https://console.apify.com/account/integrations?fpr=ymnoit&utm_source=apify-readme&utm_medium=referral
```

### Key features

- **Name or number.** Each line is a business name, typed the way you have it (`Tesla Inc`, `The Home Depot, Inc.`), or the state's own entity number. Punctuation, `L.L.C.` versus `LLC` and a leading or trailing `The` do not stop a match.
- **Ranked, not dumped.** The state index is asked for every entity whose name starts with your words; the actor ranks them (same name and suffix first, then active, then shorter) and reads only the best ones in full. `search_matches` says how many there were.
- **Status you can branch on.** `status` keeps the state's own words (Good Standing, Forfeited, Inactive-Dissolved); `is_active` turns them into true or false, and `entity_type_family` turns dozens of type names into corporation, llc, nonprofit, limited_partnership, llp and a few more.
- **Officers and agents.** Registered agent name and address where the state publishes them, and officers with titles and business addresses in Connecticut, Pennsylvania, Oregon and New York. Home addresses that one state publishes for its officers are never copied.
- **Annual reports and filings.** The latest annual or biennial report date, the next due date, and the filing history newest first, with the full count in `filings_count`.
- **Polite by design.** At most one request per second per state host, as their robots.txt asks, on the Apify datacenter proxy. A state that stops answering is switched off for the rest of the run, and the error rows say which lines to run again.

### States covered

| State | Source | Statuses | Agent | Officers | Annual reports and filings |
|---|---|---|---|---|---|
| New York | Department of State open data (data.ny.gov) | Active, plus inactive from the filings index | Yes, and the service of process address | CEO and chairman where filed | Biennial statements, filing history |
| Colorado | Secretary of State open data (data.colorado.gov) | All | Yes | Not published | Periodic reports, filing history |
| Connecticut | Secretary of the State open data (data.ct.gov) | All | Yes | Yes, with titles | Annual reports, due date, filing history |
| Oregon | Secretary of State open data (data.oregon.gov) | Active | Yes | Where filed | Not published |
| Pennsylvania | Department of State open data (data.pa.gov) | Currently registered | Not published | Yes, with titles | Not published |
| Texas | Comptroller of Public Accounts open data (data.texas.gov) | Active franchise taxpayers | Not in this file | Not in this file | Not published |
| Idaho | Secretary of State SOSBiz (sosbiz.idaho.gov) | All | Yes | Not in the record API | Next annual report due date |

Texas rows come from the Comptroller's file of active franchise taxpayers, which carries the Secretary of State file number, charter date, SOS status and the right to transact business in Texas, plus the NAICS code. It covers for profit entities that owe franchise tax, not every Texas filing.

**Not covered, and why** (tested 27 Oct 2026; we do not solve CAPTCHAs or get round blocks):

- Florida (Sunbiz): every request gets a Cloudflare "Just a moment" challenge.
- Washington: the search API needs a Cloudflare Turnstile token on each call.
- Georgia, North Carolina, Iowa: the business searches answer with a Cloudflare challenge.
- Ohio: the business search answers 403 with a maintenance page.
- Michigan: the MiBusiness Registry answers 403 to automated requests.
- California: bizfile Online blocks automated requests; the official API needs a personal key.
- Other states: not added yet. A state that is asked for but not covered gets an info row and is never charged.
- Texas SOSDirect: paid, with a login. The Comptroller's open file is used instead.

### How to use it

#### Verify a counterparty (KYB)

```json
{
  "searches": ["TX: Dell Inc.", "CT: Tesla, Inc."],
  "maxResultsPerState": 1,
  "exactMatch": true
}
```

One row per line. Check `exact_name_match`, `is_active`, `status`, `state_of_formation` and `registered_agent_name` against what the counterparty told you, and keep `source_url` as the source.

#### Every state an entity is registered in

```json
{
  "searches": ["Tesla, Inc."],
  "maxResultsPerState": 1
}
```

The best match in each of the seven states. Foreign registrations show `domestic_or_foreign: "foreign"` and the home state in `state_of_formation`.

#### Look up by entity number

```json
{
  "searches": ["NY: 1679154", "CO: 20091632423", "CT: 1075301", "PA: 0003744369"]
}
```

A number returns the entity that carries it. In Texas both the 11 digit taxpayer number and the 10 digit SOS file number work. Put the state in front so the number is not tried in every state.

#### Prospect list of similar names

```json
{
  "searches": ["Smith Consulting"],
  "states": ["CO", "CT", "OR"],
  "maxResultsPerState": 25,
  "activeOnly": true
}
```

Up to 50 entities per state for each line, active ones only, each with agent and principal address.

### Input parameters

| Parameter | Type | Default | What it does |
|---|---|---|---|
| `searches` | array of strings | empty | Business names or entity numbers, one per line, up to 5,000. `TX: Dell Inc.` searches one state. |
| `states` | array of strings | all seven | `NY`, `CO`, `CT`, `OR`, `PA`, `TX`, `ID`. |
| `maxResultsPerState` | integer | `3` | Entities per line per state, 1 to 50. 1 returns the best match. |
| `exactMatch` | boolean | `false` | Only names that are the same as yours apart from punctuation. |
| `minNameMatchScore` | number | `0.5` | Leaves out matches whose `name_match_score` is lower, 0 to 1. |
| `activeOnly` | boolean | `false` | Leaves out dissolved, forfeited, withdrawn and other inactive entities. |
| `includeFilingHistory` | boolean | `true` | Adds the filing history and annual reports list in NY, CO and CT. |
| `maxFilingsPerEntity` | integer | `25` | Newest filings kept per entity, 1 to 200. |

Moving from another Secretary of State actor? Its `companyName`, `companyNames`, `searchQuery` and `searchQueries` fields are read too, as lines of `searches`.

### What data do you get?

One row per entity per state. Entity rows have no `_type` field; the summary, info and error rows do, so a filter on `_type` separates them.

| Field | What it is |
|---|---|
| `entity_name`, `entity_number`, `state` | Legal name, the state's entity id, the state the row comes from |
| `entity_type`, `entity_type_family` | Type in the state's words, and one family: corporation, llc, nonprofit, limited_partnership, llp, general_partnership, trust, cooperative, assumed_name, other |
| `status`, `status_detail`, `is_active` | Status in the state's words, more detail, and true or false |
| `formation_date`, `state_of_formation`, `domestic_or_foreign` | Formed or registered on, where it was formed, domestic or foreign |
| `principal_address`, `principal_street`, `principal_city`, `principal_state`, `principal_zip` | Principal office, in one line and split |
| `mailing_address`, `county` | Mailing address, county where published |
| `registered_agent_name`, `registered_agent_address` | Registered agent and address |
| `service_of_process_name`, `service_of_process_address` | New York's address for service of process |
| `officers`, `officers_count` | Name, title and business address of each officer, manager, member or partner the state lists |
| `last_annual_report_date`, `annual_report_due_date`, `annual_reports` | Latest report filed, next one due, and the reports list |
| `filing_history`, `filings_count` | Filings newest first, and how many there are |
| `business_email`, `naics_code`, `naics_description`, `other_ids` | Business email (CT), NAICS code (TX, CT) and its name (CT), Texas taxpayer and file numbers |
| `source`, `source_url`, `data_scope` | The official source, the page to check it by hand, and what the source covers |
| `search_query`, `input_index`, `match_type` | The input line, its position, name or number |
| `name_match_score`, `exact_name_match`, `matched_name` | How close the name is, whether it is exact, and the name the match was made on when it differs (a former name) |
| `search_rank`, `search_matches` | Its place among the matches in that state, and how many matched |
| `scraped_at` | When the row was written |

**Summary row** (`_type: "summary"`, never charged): `inputs_requested`, `inputs_found`, `inputs_not_found`, `inputs_failed`, `state_searches_run`, `state_searches_failed`, `entities_delivered`, `charged_for`, `by_state` (searches, found, rows, requests and kilobytes per state), `http_requests`, `ended_on_deadline`, `stopped_by_max_cost`, and `shortfall_reason` when fewer entities came back than asked. The same summary is saved as the `OUTPUT` record of the run.

**Error rows** (`_type: "error"`, never charged): one per line that found nothing, with `error_type` (`not_found`, `invalid_input`, `invalid_state`, `fetch_error`, `state_unavailable`, `state_not_covered`), `identifier`, `input_index` and `reason`.

#### Stable fields for automations

These were present in every entity row of our 46 line test run (239 rows across seven states), and their names will not change:

| Field | What it is |
|---|---|
| `entity_name` | Legal name |
| `entity_number` | The state's entity id |
| `state` | State the row comes from |
| `entity_type` | Type in the state's words |
| `entity_type_family` | Type family |
| `status` | Status in the state's words |
| `is_active` | true or false |
| `officers_count` | Number of officers (0 when none) |
| `source` | Official source |
| `source_url` | Page to check it by hand |
| `data_scope` | What the source covers |
| `search_query` | The input line |
| `input_index` | Its position in your list |
| `match_type` | name or number |
| `search_rank` | Place among the matches |
| `search_matches` | How many matched |
| `scraped_at` | When the row was written |

Optional, present only when the state publishes a value (rows filled, and the states that fill it, from the same 239 rows): `formation_date` (235; all seven), `state_of_formation` (188; NY, CO, CT, OR, PA, TX, ID), `principal_address` (163; NY, CO, CT, OR, PA, ID), `mailing_address` (131; CO, CT, OR, TX, ID), `registered_agent_name` (140; NY, CO, CT, OR, ID), `registered_agent_address` (141; NY, CO, CT, OR, ID), `officers` (73; NY, CT, OR, PA), `last_annual_report_date` (70; NY, CO, CT), `annual_report_due_date` (54; CT, ID), `filing_history` (105; NY, CO, CT), `county` (73; NY, PA), `business_email` (24; CT), `naics_code` (45; CT, TX).

#### Output examples

Tesla in Connecticut, found by name, with officers, agent and annual reports (test run, 27 Oct 2026, filing lists trimmed):

```json
{
  "entity_name": "TESLA, INC.",
  "entity_number": "1075301",
  "state": "CT",
  "entity_type": "Stock",
  "entity_type_family": "corporation",
  "status": "Active",
  "is_active": true,
  "formation_date": "2012-06-14",
  "state_of_formation": "TX",
  "domestic_or_foreign": "foreign",
  "principal_address": "1 Tesla Road, Austin, TX, 78725",
  "principal_street": "1 Tesla Road",
  "principal_city": "Austin",
  "principal_state": "TX",
  "principal_zip": "78725",
  "mailing_address": "1 Tesla Road, Austin, TX, United States, 78725",
  "registered_agent_name": "C T CORPORATION SYSTEM",
  "registered_agent_address": "C T Corporation System, 357 East Center Street, Ste. 2 J, Manchester, CT, 06040-4471, United States",
  "officers": [
    {
      "name": "Elon Musk",
      "title": "Officer, Director",
      "address": "1 Tesla Road, Austin, TX, 78725"
    },
    {
      "name": "Emmanuelle Stewart",
      "title": "Officer",
      "address": "1 Tesla Road, Austin, TX, 78725"
    }
  ],
  "officers_count": 2,
  "annual_report_due_date": "2027-06-14",
  "last_annual_report_date": "2026-05-19",
  "annual_reports": [
    {
      "date": "2026-05-19",
      "type": "Annual Report"
    },
    {
      "date": "2025-06-26",
      "type": "Annual Report"
    }
  ],
  "filing_history": [
    {
      "date": "2026-05-19",
      "type": "Annual Report"
    },
    {
      "date": "2025-06-26",
      "type": "Annual Report"
    }
  ],
  "filings_count": 19,
  "business_email": "cls-ctarmsevidence@wolterskluwer.com",
  "naics_code": "336320",
  "naics_description": "Motor Vehicle Electrical and Electronic Equipment Manufacturing",
  "source": "Connecticut Secretary of the State, Business Registry (data.ct.gov)",
  "source_url": "https://service.ct.gov/business/s/onlinebusinesssearch",
  "data_scope": "All statuses; officers, agent and filings from the registry tables",
  "search_query": "Tesla, Inc.",
  "input_index": 1,
  "match_type": "name",
  "name_match_score": 1,
  "exact_name_match": true,
  "search_rank": 1,
  "search_matches": 18,
  "scraped_at": "2026-10-27T18:26:21.884Z"
}
```

Dell in Texas, from the Comptroller file, with the SOS file number and right to transact business:

```json
{
  "entity_name": "DELL INC.",
  "entity_number": "0007444706",
  "state": "TX",
  "entity_type": "Foreign Profit Corporation",
  "entity_type_family": "corporation",
  "status": "Active",
  "status_detail": "Right to transact business in Texas: Active",
  "is_active": true,
  "formation_date": "1987-10-27",
  "domestic_or_foreign": "foreign",
  "mailing_address": "ONE DELL WAY RR1-35 TAX DEPT, AUSTIN, TX, 78714",
  "officers_count": 0,
  "naics_code": "551112",
  "other_ids": {
    "tx_taxpayer_number": "17424878340",
    "tx_sos_file_number": "0007444706",
    "tx_file_number_type": "Certificate of authority",
    "tx_franchise_tax_since": "1987-10-27"
  },
  "source": "Texas Comptroller of Public Accounts, Active Franchise Taxpayers (data.texas.gov)",
  "source_url": "https://comptroller.texas.gov/taxes/franchise/account-status/search",
  "data_scope": "Active franchise taxpayers; the address is the tax mailing address; no agent or officers in this file",
  "search_query": "Dell Inc.",
  "input_index": 2,
  "match_type": "name",
  "name_match_score": 1,
  "exact_name_match": true,
  "search_rank": 1,
  "search_matches": 74,
  "scraped_at": "2026-10-27T18:25:03.707Z"
}
```

An error row for a name no covered state has (nothing charged):

```json
{"_type": "error", "error_type": "not_found", "identifier": "Xyzzqv Nonexistent Holdings LLC", "input_index": 38, "states_searched": ["ID", "OR", "PA", "TX", "NY", "CO", "CT"], "reason": "No entity named like \"Xyzzqv Nonexistent Holdings LLC\" in ID, OR, PA, TX, NY, CO, CT.", "scraped_at": "2026-10-27T18:31:11.141Z"}
```

### Pricing

Pay per event: you pay for each entity row you receive, plus a flat $0.002 per run, whatever memory you choose. Officers, agents, annual reports and the filing history in a row cost nothing extra.

| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
| `entity-scraped` | Once per entity row stored in your dataset | $1.80 per 1,000 | $1.52 per 1,000 | $1.28 per 1,000 | $1.08 per 1,000 |
| `run-start` | Once per run, after the first entity row is stored | $0.002 | $0.002 | $0.002 | $0.002 |

The price of one entity is the price per 1,000 divided by 1,000.

Never charged:

- names and numbers no covered state has an entity for (each gets an error row);
- states that are not covered, such as Florida (you get an info row saying why);
- an entity that a second line of the same run finds again;
- the summary, info and error rows;
- a run that stores no entity row: the start fee is charged only after the first one;
- anything past your "Max cost per run". The actor checks the budget before each row and stops while the total is still below your limit, so the run ends SUCCEEDED with a partial result and a status message saying so.

### Run it on a schedule

1. Open the actor in Apify Console, put your entity numbers (from a first run, with the state in front) in the input and click **Save as a new task**.
2. In the task, open **Schedules**, click **Add schedule** and pick how often (every Monday at 08:00, every month and so on).
3. Compare runs on `state` plus `entity_number` and watch `status`, `is_active`, `registered_agent_name`, `principal_address` and `last_annual_report_date` to catch a forfeiture, a dissolution, a new agent or a missed annual report.
4. Optional: add an integration (Google Sheets, a CRM through Make or Zapier, a webhook) so each run lands where your team works.

### FAQ

#### What does this actor read?

The open data each state publishes on its official portal (data.ny.gov, data.colorado.gov, data.ct.gov, data.oregon.gov, data.pa.gov, data.texas.gov) through the public Socrata API, and the Idaho Secretary of State's own business search. It does not log in, does not solve CAPTCHAs and reads nothing a member of the public cannot open.

#### How fresh is the data?

The state portals refresh these datasets daily or weekly (all seven were updated in the week of our test, 27 Oct 2026), and Idaho is read live. A filing made today can take a few days to show in the open data. For a same day check, open `source_url`.

#### Why is Florida not covered?

Sunbiz answers every automated request, from any network, with a Cloudflare challenge, and we do not get round challenges. The same goes for Washington, Georgia, North Carolina, Iowa, Ohio, Michigan and California. The info row of a run that asks for them says why, and they are never charged.

#### How sure is a name match?

`name_match_score` is 1 when the name is the same as yours apart from punctuation and the legal suffix matches, 0.95 when only the suffix differs (`Dell Inc` and `DELL CORPORATION`), and lower for partial matches; matches below `minNameMatchScore` (0.5) are left out. `exactMatch: true` keeps only exact ones. When a match was made on a former name, `matched_name` shows it (Zoom Video Communications, Inc. is now ZOOM COMMUNICATIONS, INC. in New York). For a common name, use the entity number or add more words.

#### Why are officers empty for some states?

Colorado and Texas do not publish officers in their open data, and New York lists only a CEO or chairman on some records. Connecticut and Pennsylvania publish officers for most entities. Every row says what its source covers in `data_scope`.

#### Why does Texas say "Active franchise taxpayers"?

The Texas Secretary of State's own search (SOSDirect) is paid and needs a login. The Comptroller publishes the active franchise taxpayer file for free, with the SOS file number, charter date, SOS status and right to transact business, so that is what this actor reads.

#### How long does a run take?

About 20 seconds for one name across all seven states, which is the usual call from Clay or an agent, and up to 90 seconds when a state portal answers slowly. Our 46 line test across all seven states (239 entities, one per state) took 4.8 minutes. Each state answers in about 1 to 3 seconds and the actor keeps to one request per second per state, so a large batch runs at roughly 10 lines a minute across all seven states, and faster with fewer states.

#### Do I need an account, cookies or a proxy?

No. The actor reads public pages over Apify Proxy, which is included. Nothing to set up.

#### Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes, through Apify's MCP server. Connector URL: https://mcp.apify.com/?tools=themineworks/secretary-of-state-business-search

- Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
- ChatGPT: turn on developer mode, add an MCP connector with the URL, sign in with Apify.
- Cursor or VS Code: add it as an HTTP MCP server with that URL.
- Claude Code: `claude mcp add -t http secretary-of-state-business-search "https://mcp.apify.com/?tools=themineworks/secretary-of-state-business-search"`

#### Which formats can I download?

JSON, CSV, Excel, XML, RSS and HTML from the run's Storage tab or through the API. The dataset has three ready views: Entities, KYB check, and Agents and officers. In CSV and Excel, `officers` and `filing_history` are flattened into columns such as `officers/0/name`.

#### Is it legal to use this data?

Business entity filings are public records that the states publish as open data for reuse, and this actor reads only those public sources at the pace their robots.txt asks for. Some fields name people (registered agents, officers); you are responsible for how you use them, including the FCRA if you use records for credit, employment or tenant decisions, and state privacy laws. This is general information, not legal advice.

### Integrations

- **Clay**: add an HTTP or Apify enrichment column that sends the business name (with the state in front when you know it) as `searches` and maps the row back with `input_index`.
- **Make, Zapier and n8n**: start a run and read its dataset with the Apify apps and nodes, for example "check a new vendor's registration when it is added to the sheet".
- **Webhooks**: have Apify call your URL when a run succeeds, then fetch the dataset.
- **API and SDKs**: run it from Python or JavaScript with the Apify client, or with a plain HTTP call (see "Copy to your AI assistant" above).
- **MCP clients**: Claude, ChatGPT, Cursor and VS Code can run it as a tool through the connector URL in the FAQ.

### More from The Mine Works

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [EU VAT Checker (VIES)](https://apify.com/themineworks/eu-vat-vies-validator?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Tech Stack Detector](https://apify.com/themineworks/tech-stack-detector?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Bundesanzeiger Scraper](https://apify.com/themineworks/germany-bundesanzeiger-monitor?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Domain to LinkedIn URL Resolver](https://apify.com/themineworks/domain-to-linkedin-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [World Bank Trade Scraper](https://apify.com/themineworks/global-trade-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [US Import Records](https://apify.com/themineworks/us-import-supplier-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Y Combinator Scraper](https://apify.com/themineworks/y-combinator-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Norway Company Register](https://apify.com/themineworks/norway-brreg-entity-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Social media and video**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**More tools**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### Support

Found an entity that the state's own search shows but this actor does not, or a state you need? Open an issue in the Issues tab with the input and the run ID, and we will look at it. For a field you need or a new state, email dmineworks@gmail.com.

*Search US Secretary of State business registries by name or entity number and get the legal name, status, formation date, addresses, registered agent and officers back as one row per entity, no login.*

# Actor input Schema

## `searches` (type: `array`):

One per line: a business name (Tesla, Inc.) or the state's entity number (1679154). Put a state code in front to search one state only: TX: Dell Inc. or NY: 1679154. Up to 5,000 lines per run.

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

States to search. Leave empty to search all seven covered states: New York, Colorado, Connecticut, Oregon, Pennsylvania, Texas and Idaho.

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

How many matching entities to return for each line in each state, 1 to 50. 1 returns the best match per state, which is what you want for KYB and enrichment.

## `exactMatch` (type: `boolean`):

On: only entities whose name is the same as yours apart from punctuation (Tesla Inc matches TESLA, INC.). Off: the closest names are returned too, ranked by name_match_score.

## `minNameMatchScore` (type: `number`):

Leave out matches whose name_match_score is below this, 0 to 1. 0.5 drops loose partial matches; 0.9 keeps only names that start with all your words or are the same; 0 keeps everything the state index returns.

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

On: dissolved, forfeited, withdrawn and other inactive entities are left out. Off: every status is returned and is_active says which is which.

## `includeFilingHistory` (type: `boolean`):

On: adds the filing history and the list of annual reports where the state publishes them (NY, CO, CT), one extra request per state, same price. The latest annual report date is filled either way for CT.

## `maxFilingsPerEntity` (type: `integer`):

Newest filings kept in filing_history, 1 to 200. filings_count always gives the full count.

## Actor input object example

```json
{
  "searches": [
    "Tesla, Inc.",
    "Dell Inc.",
    "CO: 20091632423"
  ],
  "maxResultsPerState": 3,
  "exactMatch": false,
  "minNameMatchScore": 0.5,
  "activeOnly": false,
  "includeFilingHistory": true,
  "maxFilingsPerEntity": 25
}
```

# Actor output Schema

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

No description

## `summary` (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 = {
    "searches": [
        "Tesla, Inc.",
        "Dell Inc.",
        "CO: 20091632423"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/secretary-of-state-business-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 = { "searches": [
        "Tesla, Inc.",
        "Dell Inc.",
        "CO: 20091632423",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("themineworks/secretary-of-state-business-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 '{
  "searches": [
    "Tesla, Inc.",
    "Dell Inc.",
    "CO: 20091632423"
  ]
}' |
apify call themineworks/secretary-of-state-business-search --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,themineworks/secretary-of-state-business-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/JgicSP3pI5yMT7Z13/builds/O1CdfmbnfuVhBv8e5/openapi.json
