Secretary of State Business Search: KYB, Agents, Officers avatar

Secretary of State Business Search: KYB, Agents, Officers

Pricing

from $1.08 / 1,000 entities

Go to Apify Store
Secretary of State Business Search: KYB, Agents, Officers

Secretary of State Business Search: KYB, Agents, Officers

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.

Pricing

from $1.08 / 1,000 entities

Rating

0.0

(0)

Developer

The Mine Works

The Mine Works

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

16 days ago

Last modified

Features

Limited permissions

Share

US business entities from seven Secretary of State registries, one row per entity

From The Mine Works, makers of Company KYB Resolver and B2B Leads Finder, 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

Part of The Mine Works Company and business data family: Company Domain Finder, GST Taxpayer Lookup, Company KYB Resolver, SEC EDGAR Filings Scraper, EU VAT Checker (VIES), Tech Stack Detector.

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):

{
"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

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

StateSourceStatusesAgentOfficersAnnual reports and filings
New YorkDepartment of State open data (data.ny.gov)Active, plus inactive from the filings indexYes, and the service of process addressCEO and chairman where filedBiennial statements, filing history
ColoradoSecretary of State open data (data.colorado.gov)AllYesNot publishedPeriodic reports, filing history
ConnecticutSecretary of the State open data (data.ct.gov)AllYesYes, with titlesAnnual reports, due date, filing history
OregonSecretary of State open data (data.oregon.gov)ActiveYesWhere filedNot published
PennsylvaniaDepartment of State open data (data.pa.gov)Currently registeredNot publishedYes, with titlesNot published
TexasComptroller of Public Accounts open data (data.texas.gov)Active franchise taxpayersNot in this fileNot in this fileNot published
IdahoSecretary of State SOSBiz (sosbiz.idaho.gov)AllYesNot in the record APINext 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)

{
"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

{
"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

{
"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

{
"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

ParameterTypeDefaultWhat it does
searchesarray of stringsemptyBusiness names or entity numbers, one per line, up to 5,000. TX: Dell Inc. searches one state.
statesarray of stringsall sevenNY, CO, CT, OR, PA, TX, ID.
maxResultsPerStateinteger3Entities per line per state, 1 to 50. 1 returns the best match.
exactMatchbooleanfalseOnly names that are the same as yours apart from punctuation.
minNameMatchScorenumber0.5Leaves out matches whose name_match_score is lower, 0 to 1.
activeOnlybooleanfalseLeaves out dissolved, forfeited, withdrawn and other inactive entities.
includeFilingHistorybooleantrueAdds the filing history and annual reports list in NY, CO and CT.
maxFilingsPerEntityinteger25Newest 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.

FieldWhat it is
entity_name, entity_number, stateLegal name, the state's entity id, the state the row comes from
entity_type, entity_type_familyType 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_activeStatus in the state's words, more detail, and true or false
formation_date, state_of_formation, domestic_or_foreignFormed or registered on, where it was formed, domestic or foreign
principal_address, principal_street, principal_city, principal_state, principal_zipPrincipal office, in one line and split
mailing_address, countyMailing address, county where published
registered_agent_name, registered_agent_addressRegistered agent and address
service_of_process_name, service_of_process_addressNew York's address for service of process
officers, officers_countName, title and business address of each officer, manager, member or partner the state lists
last_annual_report_date, annual_report_due_date, annual_reportsLatest report filed, next one due, and the reports list
filing_history, filings_countFilings newest first, and how many there are
business_email, naics_code, naics_description, other_idsBusiness email (CT), NAICS code (TX, CT) and its name (CT), Texas taxpayer and file numbers
source, source_url, data_scopeThe official source, the page to check it by hand, and what the source covers
search_query, input_index, match_typeThe input line, its position, name or number
name_match_score, exact_name_match, matched_nameHow 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_matchesIts place among the matches in that state, and how many matched
scraped_atWhen 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:

FieldWhat it is
entity_nameLegal name
entity_numberThe state's entity id
stateState the row comes from
entity_typeType in the state's words
entity_type_familyType family
statusStatus in the state's words
is_activetrue or false
officers_countNumber of officers (0 when none)
sourceOfficial source
source_urlPage to check it by hand
data_scopeWhat the source covers
search_queryThe input line
input_indexIts position in your list
match_typename or number
search_rankPlace among the matches
search_matchesHow many matched
scraped_atWhen 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):

{
"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:

{
"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):

{"_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.

EventWhen it is chargedFree planBronze (Starter)Silver (Scale)Gold (Business)
entity-scrapedOnce 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-startOnce 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.

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

Social media and video

Leads and business directories

Marketing, SEO and reviews

LinkedIn

Real estate

Science, health and government data

Jobs and hiring

E-commerce and marketplaces

Food and local services

Developer and AI tools

More tools

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.