Secretary of State Business Entity Search - 23 States KYB
Pricing
from $2.50 / 1,000 business records
Secretary of State Business Entity Search - 23 States KYB
Secretary of State business entity search across 23 states. Agent, officer or street in CO, CT, FL, NY, OR, RI. AR: agent. WV: agent, street. PA: officer, street. MN, VT, PA, OR, CO, CT, NY, FL, ID, ND, AR, KY, DE, RI, WV file numbers. Filings, former names in FL, KY, NY, CO, CT, MN, RI, WV. CA key.
Pricing
from $2.50 / 1,000 business records
Rating
0.0
(0)
Developer
Muhamed Didovic
Maintained by CommunityActor stats
0
Bookmarked
6
Total users
4
Monthly active users
10 hours ago
Last modified
Categories
Features
Share
US Business Entity Search (Secretary of State)
Look up any company in official US state business registries, several states in one run. Give it company names, a Minnesota file number as printed, a Vermont entity number, a Pennsylvania filing number, an Oregon registry number, a Colorado entity id, a Connecticut account number or filing number, a New York DOS id or filing number, a Florida document number, an Idaho filing number, a North Dakota filing number, an Arkansas filing number, a Kentucky organization number, a Delaware file number, a Rhode Island identification number or filing number, a West Virginia record id, or for Texas a taxpayer number, EIN, SOS file number, or a filter on charter date, city, county, ZIP, NAICS and entity type. Each match comes back as one normalized record: legal name, state file number, entity type, status, formation date, home jurisdiction, registered agent with address, officers and managers, principal and mailing addresses, and a link to the official source. 22 states with no key: Florida (Sunbiz), Texas, New York, New Jersey, Delaware, Vermont, the District of Columbia, Colorado, Connecticut, Oregon, Minnesota, Kentucky, Alabama, Idaho, West Virginia, North Dakota, Iowa, Wisconsin, Pennsylvania, Arkansas, Rhode Island and Missouri. California is the 23rd, and it uses your own free CALICO key. JSON or CSV out, billed per record.
How it works

✨ Why use this scraper?
- One schema for every state. Each registry publishes different fields under different names. You get the same columns whether the record came from Sunbiz HTML, the Texas Comptroller API or a Socrata open-data feed.
- Florida included. Sunbiz is the registry most KYB checks need and the one most multi-state tools skip. This actor reads it, officers and authorized persons included.
- Officers, not only names. Florida, Texas, West Virginia, Connecticut, Minnesota and New York return directors, managers, members or the CEO with addresses where the state publishes them.
- Bulk input. Paste a list of company names. Every name runs against every selected state, in parallel.
- Three match modes.
contains,startsWith, andexact, which ignores punctuation and legal-form words, so "Goldman Sachs" matches "GOLDMAN SACHS & CO. LLC". - Fails loudly. A registry that is down shows up in
FAILED_SEARCHESand in the run status, instead of a silent empty result.
Overview
The actor queries each state's official source directly: public open-data APIs where the state publishes one, the state's own JSON endpoint where it exists, and the public search pages otherwise. No login and no browser. California is the only state that asks for a key, the free CALICO subscription key from calicodev.sos.ca.gov. Leave states empty and that key out, and the run covers the other 22.
Supported inputs
| State | Source | Match modes | Detail fields |
|---|---|---|---|
| Florida | Division of Corporations (Sunbiz) | starts with, exact, plus registered agent, officer and street | status, type, FEIN, filing date, last event, principal + mailing address, registered agent, officers / authorized persons, the newest filings (date and filing), and previous names when the registry lists them. With Include UCC filings on, financing statements for that exact company name: filing date, lapse date, status and secured party |
| Texas | Comptroller of Public Accounts (franchise tax + SOS data) | all, plus taxpayer number, EIN and SOS file number | SOS file number, SOS status, right to transact, entity type, county, NAICS, formation state and date, registered agent, officers / managers, FEIN, DBA. Also lists entities by charter date, city, county, ZIP, NAICS or entity type |
| New York | Department of State (data.ny.gov) | all, plus registered agent, chairman or CEO, and street | DOS ID, type, county, jurisdiction, filing date, registered agent, service-of-process address, chairman / CEO, principal location, the newest filings (filing, file date, effective date), and former names when the registry lists an inactive name |
| Colorado | Secretary of State (data.colorado.gov) | all, plus registered agent, street and entity id | entity ID, type, status, jurisdiction, formation date, principal + mailing address, registered agent, the newest filings (filing, file date, effective date), and former names from an entity name change. With Include UCC filings on, financing statements for that exact company name: filing date, termination, secured party and collateral |
| Connecticut | Secretary of the State (data.ct.gov) | all, plus registered agent, officer and street | account number, type, status, formation place and date, principal + mailing address, registered agent, principals, NAICS, business email, the newest filings (filing, file date, effective date), and former names from a name change. With Include UCC filings on, financing statements for that exact company name: filing date, lapse date, termination and secured party |
| Oregon | Secretary of State (data.oregon.gov) | all, plus registered agent, officer, street and registry number | registry number, type, registry date, principal + mailing address, registered agent, authorized representative |
| Minnesota | Secretary of State (Business Filings) | all, plus file number | file number, type, status, home jurisdiction, filing date, registered agent and office, CEO / manager, renewal due date, the newest filings (filing, file date, effective date), and former business names |
| Kentucky | Secretary of State (Business Entity Search) | all | organization number, type, status, standing, home state, file date, last annual report, principal office, registered agent, current officers, former names, the newest filings (filing, file date, effective date), industry, employees. With Include UCC filings on, financing statements for that exact company name: file number, filing date, lapse date and secured party |
| Alabama | Secretary of State (Business Entity Records) | all | entity ID, type, status, place and date of formation, qualify date, principal + mailing address, registered agent and office. With Include UCC filings on, filings for that exact company name: file number, type, status, filing date, expiration date, secured party, and the debtor address |
| Idaho | Secretary of State (SOSbiz) | all | record number, type, status, standing, formed in, filing date, principal + mailing address, registered agent, annual report due date. With Include UCC filings on, liens for that exact company name: file number, type, status, filing date, lapse date and secured party |
| West Virginia | Secretary of State (Business Organizations) | all, plus registered agent and street | org ID, charter and class, charter state, filing date, termination, notice-of-process agent, principal + mailing address, officers, DBAs, business purpose, the newest amendments and annual report years, and former names from a name change |
| New Jersey | Division of Revenue & Enterprise Services | all | entity ID, type, city, incorporation date |
| North Dakota | Secretary of State (FirstStop) | all | record number, type, status, standing, filing date |
| Iowa | Secretary of State (Business Entities Search) | starts with (contains is filtered after a prefix search) | business number, type, status, filing date, registered agent, principal office, officers |
| Wisconsin | Department of Financial Institutions (Corporate Records) | all | entity ID, type, effective date, status. Detail adds the registered agent and principal office when the page publishes them. With Include UCC filings on, filings for that exact company name: file number, type, status, filed date, secured party, and the debtor's city and state |
| Pennsylvania | Department of State (data.pa.gov, current registrations) | all, plus officer, street and filing number | filing number, type, formation date, address, county, parties (directors, officers, members) |
| Arkansas | Secretary of State (Corporation Search) | all, plus registered agent | filing number, type, status, filing date, registered agent, officers, fictitious names, state of origin. With Include UCC filings on, filings for that exact company name: file number, type, status, filing date, lapse date, secured party, and the debtor's city |
| Rhode Island | Department of State (Business Portal) | all, plus registered agent, officer and street | ID number, type, qualification date, NAICS, principal and mailing address, registered agent, officers, and former names when the registry lists a legal name change. With Include UCC filings on, filings for that exact company name: file number, type, filing date, secured party, debtor address, and collateral when the filing history prints it |
| Missouri | Secretary of State (Business Entity Search) | all | charter number, type, status, formed date, home state, registered agent, principal office |
| Delaware | Division of Corporations (Entity Search) | all | file number, entity kind, formation date, residency, home state, registered agent and address |
| Vermont | Secretary of State (Business Services) | all, plus entity number | entity number, type, status, principal address, registered agent, email and NAICS when the record has them |
| District of Columbia | Department of Licensing and Consumer Protection (Business Search) | all | entity number, type, status, effective date, principal address, registered agent |
| California | Secretary of State CALICO API (your key) | contains, starts with | entity number, type, status, filing date, jurisdiction, agent, principal and mailing address, SOS/FTB standing |
Not supported yet:
- Other states. More registries are in progress; ask in the Issues tab if you need a specific one first.
- California without
caApiKey. An all-states run skips California until you paste a key. Selecting California with no key fails that state and leaves the others running. - Florida "contains" search. The registry only searches by the start of the name, the officer, the agent or the street, so
containsbehaves likestartsWiththere. An officer can be entered as First Last; the index is Last, First. The officer lookup also returns a registered agent of that name. The agent lookup is registered agents only. A street is the address on the record. Officer and agent lists omit status until the detail record is read. - New Jersey status, agent and officers. New Jersey sells these as paid business records; its free search lists name, ID, type, city and incorporation date only, so
statusandisActivearenullfor NJ rows andactiveOnlycannot filter them. - Delaware status, tax, filing history and officers. The free record is the file number, entity kind, formation date, residency and registered agent. Status is a paid record, so
statusandisActivearenullfor Delaware rows andactiveOnlycannot filter them. - Kentucky filing activity is the newest filings on the record. Older filings stay on the registry. Former names include the action the registry prints, such as a merger.
- New York officer search is the chairman or CEO on the active record. New York street search is the principal location street. New York, Colorado, Connecticut and Minnesota filing activity is the newest 25 filings. Older filings stay on the registry. New York former names are inactive names. Colorado former names are the previous legal name from an entity name change. Connecticut former names are the previous legal name and the date of the change. Minnesota former names are earlier business names in the filing history, and its filings also include annual renewals. Rhode Island former names are earlier legal names from a name change. A fictitious name is not listed as a former name. West Virginia filings are the newest amendments and annual report years, at most 25. An annual report lists the year and no month or day, so its filing date is empty. Former names are the old name and the date of the change.
- North Dakota officers and addresses. FirstStop's detail service returns an error for every record right now, so ND rows carry search-level fields only (
detailLevel: "listing"). - New York, Oregon and Pennsylvania inactive entities. Those open-data extracts publish current registrations only, so a dissolved company is absent rather than returned as inactive.
- Iowa prefix search. The registry matches the start of the name, so
containscannot find a word in the middle of an Iowa name. - Pennsylvania registered agent. The open-data rows are parties (Governor, President, member), not a separate agent field, so
registeredAgentis empty and those people areofficers. Officer search uses those parties. Street search uses the address on the registration. A filing number is 10 digits, so 159516 matches 0000159516. Pennsylvania is searched when Pennsylvania is selected. - Oregon registry number. Leading zeros are dropped, so 008739914 matches 8739914. A shorter number stays a different company, so 873991 does not return the company numbered 8739914. Oregon is searched when Oregon is selected.
- Colorado entity id. Leading zeros are dropped, so 019981033526 matches 19981033526. A shorter number stays a different company, so 1998103352 does not return the company numbered 19981033526. Colorado is searched when Colorado is selected.
- Connecticut account number. Leading zeros stay, so 0287916 does not match 287916. A shorter number stays a different company, so 028791 does not return the company numbered 0287916. Connecticut is searched when Connecticut is selected.
- Connecticut filing number. A numeric filing number is 10 digits, such as 0005799067. 0005799068 is a different company. A filing number can also start with letters, such as BF-0010157714. The record id is the account number. Connecticut is searched when Connecticut is selected.
- New York DOS id. Leading zeros stay, so 01701167 does not match 1701167. A shorter number stays a different company, so 170116 does not return the company numbered 1701167. New York is searched when New York is selected.
- New York filing number. The number starts with a letter, such as A171209-5. A171209-6 does not match it. The result is that company, and its id on the record is the DOS id. A filing shared by several companies stays out. New York is searched when New York is selected.
- Florida document number. Letters and leading zeros stay, so L17000138980 is that company and 0112252 does not match 112252. A shorter number stays a different company, so 11225 does not return the company numbered 112252. Florida is searched when Florida is selected.
- Idaho filing number. Leading zeros are dropped, so 0000098318 matches 98318. A shorter number stays a different company, so 9831 does not return the company numbered 98318. A name that only contains those digits stays out. Idaho is searched when Idaho is selected.
- North Dakota filing number. Leading zeros are dropped, so 0000010610 matches 10610. A shorter number stays a different company, so 1061 does not return the company numbered 10610. 106100 stays a different company. North Dakota is searched when North Dakota is selected. The free record stays at search level: name, filing number, type, status and agent.
- Arkansas filing number. Leading zeros stay, so 0100067582 does not match 100067582. A shorter number stays a different company, so 10006758 does not return the company numbered 100067582. Arkansas is searched when Arkansas is selected.
- Kentucky organization number. Leading zeros are dropped, so 0059256 matches 59256. A shorter number stays a different company, so 005925 does not return the company numbered 0059256. The result is the organization. Assumed names under that number are left out. Kentucky is searched when Kentucky is selected.
- Delaware file number. Leading zeros are dropped, so 04290350 matches 4290350. A shorter number stays a different company, so 429035 does not return the company numbered 4290350. Delaware is searched when Delaware is selected. The free record has no status.
- Rhode Island identification number. The number is 9 digits and leading zeros stay, so 000015908 is that company and 15908 does not match it. 000001590 is a different company. Rhode Island is searched when Rhode Island is selected.
- Rhode Island filing number. The number is 12 digits, such as 202689281200. 202689281201 does not match it, and 20268928120 stays out. The result is the company name on that filing. Status, agent and the 9-digit identification number are not on that result. Rhode Island is searched when Rhode Island is selected.
- West Virginia record id. Leading zeros are dropped, so 0294278 matches 294278. A shorter number stays a different company, so 29427 does not return the company numbered 294278. West Virginia is searched when West Virginia is selected.
- Rhode Island registered agent. The lookup uses the first 20 characters of the agent name. Exact match then keeps the full name. Officer search accepts First Last, and a longer name does not match. Street search is the address on the record. Exact still matches when the city, state and ZIP follow the street.
- Arkansas registered agent. Spaces in the agent name are ignored, so CT CORPORATION SYSTEM matches C T CORPORATION SYSTEM. The agent is read from the company record.
- West Virginia registered agent and street. The lookup uses the first 50 characters and the first 200 organizations in the list. Exact street match still matches when the city, state and ZIP follow the street.
- Minnesota file number. The number is the full file number as printed, such as 3834-LFC. 3834 does not return the company numbered 3834-LFC. Minnesota is searched when Minnesota is one of the selected states.
- Vermont entity number. Leading zeros are ignored, so 000074657 matches 74657. 7465 does not return the company numbered 74657. Vermont is searched when Vermont is one of the selected states.
- Missouri officers. The free detail page publishes the registered agent and principal office, not the officer list.
- California officers. The CALICO search returns the agent and addresses, not directors.
🎯 Use cases
| Team | What they build |
|---|---|
| KYB / compliance | Verify that a merchant, vendor or counterparty legally exists, is in good standing, and who its officers are |
| Sales & lead generation | Find where a company is registered, its registered agent and its decision makers |
| Due diligence & M&A | Cross-check one company's filings across states: formation dates, foreign registrations, status changes |
| Legal & collections | Locate the registered agent and service-of-process address before serving papers |
| Data enrichment | Append official status, entity type and formation date to CRM or onboarding records |
Under the hood
- Each company name is paired with each selected state, and the searches run in parallel. A registered agent, officer or street is paired only with Arkansas, Colorado, Connecticut, Florida, New York, Oregon, Pennsylvania, Rhode Island or West Virginia, and only where that lookup exists. A Minnesota file number is looked up when Minnesota is selected. A Vermont entity number is looked up when Vermont is selected. A Pennsylvania filing number is looked up when Pennsylvania is selected. An Oregon registry number is looked up when Oregon is selected. A Colorado entity id is looked up when Colorado is selected. A Connecticut account number or filing number is looked up when Connecticut is selected. A New York DOS id or filing number is looked up when New York is selected. A Florida document number is looked up when Florida is selected. An Idaho filing number is looked up when Idaho is selected. A North Dakota filing number is looked up when North Dakota is selected. An Arkansas filing number is looked up when Arkansas is selected. A Kentucky organization number is looked up when Kentucky is selected. A Delaware file number is looked up when Delaware is selected. A Rhode Island identification number or filing number is looked up when Rhode Island is selected. A West Virginia record id is looked up when West Virginia is selected. A Texas SOS file number, taxpayer number or EIN is looked up in Texas.
- The adapter for each state queries that registry's own source and maps the answer onto the shared schema.
- Names are matched in the chosen mode after normalizing punctuation,
&and legal-form words. - With
includeDetailson, the detail record is fetched for each match (officers, agent, addresses). - One dataset row is pushed per unique entity per state. An entity that matches two of your names is returned and billed once.
Input configuration
In the order of the input form:
| Field | Type | Default | Description |
|---|---|---|---|
companyNames | array | — | Businesses to look up, one per line. Optional for an agent, officer or street search, and when a Texas number, a Minnesota file number, a Vermont entity number, a Pennsylvania filing number, an Oregon registry number, a Colorado entity id, a Connecticut account number or filing number, a New York DOS id or filing number, a Florida document number, an Idaho filing number, a North Dakota filing number, an Arkansas filing number, a Kentucky organization number, a Delaware file number, a Rhode Island identification number or filing number, a West Virginia record id, or a Texas filter is set. |
agentNames | array | — | Registered agents. Arkansas, Colorado, Connecticut, Florida, New York, Oregon, Rhode Island and West Virginia. Arkansas ignores spaces, so CT CORPORATION SYSTEM matches C T CORPORATION SYSTEM. Rhode Island uses the first 20 characters, then keeps a result whose full agent name matches. West Virginia uses the first 50 characters. Company and LLC stay part of the name. |
officerNames | array | — | Officers or authorized persons. Connecticut, Florida, New York, Oregon, Pennsylvania and Rhode Island. In Florida this is Last, First, and a First Last entry is accepted. In New York this is the chairman or CEO on the record. In Pennsylvania this is a party on the registration. In Rhode Island, First Last is accepted. |
streetAddresses | array | — | Streets the registry publishes. Colorado, Connecticut, Florida, New York, Oregon, Pennsylvania, Rhode Island and West Virginia. In New York this is the principal location street. In Pennsylvania this is the address on the registration. In Rhode Island and West Virginia, exact still matches when the city, state and ZIP follow the street. |
matchMode | string | contains | contains, startsWith or exact. Exact ignores LLC/Inc on a company name and keeps them on an agent, officer or street. |
states | array | every state that needs no key | FL, TX, NY, NJ, DE, VT, DC, CO, CT, OR, MN, KY, AL, ID, WV, ND, IA, WI, PA, AR, RI, MO, CA |
caApiKey | string | — | Free California Secretary of State key; needed only for CA. Stored as a secret. |
taxpayerNumbers | array | — | Texas only. 11-digit taxpayer numbers or 9-digit EINs. |
fileNumbers | array | — | Texas SOS file numbers, 6 to 10 digits. Minnesota file numbers as printed, such as 3834-LFC. Vermont entity numbers, such as 74657. Pennsylvania filing numbers, 10 digits; 159516 matches 0000159516. Oregon registry numbers, such as 8739914. Colorado entity ids, such as 19981033526. Leading zeros are dropped in Oregon and Colorado. 873991 does not match 8739914. 1998103352 does not match 19981033526. Connecticut account numbers, such as 0287916. Leading zeros stay, so 287916 does not match 0287916. Connecticut filing numbers are 10 digits, such as 0005799067, or start with letters, such as BF-0010157714. 0005799068 does not match 0005799067. The record id is the account number. New York DOS ids, such as 1701167. Leading zeros stay, so 01701167 does not match 1701167, and 170116 does not match 1701167. New York filing numbers start with a letter, such as A171209-5. A171209-6 does not match it. The result is that company. Florida document numbers, such as 112252 or L17000138980. Letters and leading zeros stay, so 11225 does not match 112252, and 0112252 does not match 112252. Idaho filing numbers, such as 98318. Leading zeros are dropped, so 0000098318 matches 98318. 9831 does not match 98318. North Dakota filing numbers, such as 10610. Leading zeros are dropped, so 0000010610 matches 10610. 1061 does not match 10610. Arkansas filing numbers, such as 100067582. Leading zeros stay, so 0100067582 does not match 100067582, and 10006758 does not match 100067582. Kentucky organization numbers, such as 0059256. Leading zeros are dropped, so 59256 matches 0059256, and 005925 does not match 0059256. The result is the organization. Assumed names under that number are left out. Delaware file numbers, such as 4290350. Leading zeros are dropped, so 04290350 matches 4290350, and 429035 does not match 4290350. Rhode Island identification numbers are 9 digits, such as 000015908. Leading zeros stay, so 15908 does not match 000015908, and 000001590 is a different company. Rhode Island filing numbers are 12 digits, such as 202689281200. 202689281201 does not match it, and 20268928120 stays out. That result is the company name on the filing. West Virginia record ids, such as 294278. Leading zeros are dropped, so 0294278 matches 294278, and 29427 does not match 294278. |
formedAfter / formedBefore | string | — | Texas only. Charter date window, YYYY-MM-DD. With no company name, lists matching entities, newest first. |
cities / counties / zipCodes | array | — | Texas only. Mailing city, county name or code, ZIP or prefix. |
naicsCodes | array | — | Texas only. NAICS code or prefix, 2 to 6 digits. |
entityTypes | array | — | Texas only. LLC, corporation, nonprofit, limited partnership, trust, or a code such as CL. |
includeDetails | boolean | true | Adds officers, registered agent and addresses to each record |
includeLiens | boolean | false | Adds UCC filings. Alabama, Arkansas, Colorado, Connecticut, Florida, Idaho, Kentucky, Rhode Island and Wisconsin; other states are marked unavailable |
activeOnly | boolean | false | Leaves out dissolved, withdrawn, revoked and other inactive entities |
onlyNew | boolean | false | Skips entities a previous run already returned, and does not bill them. The first run returns the current matches and remembers them. |
monitorName | string | one memory for this actor | Separate memories, for example one per city. Used only when onlyNew is on. |
maxItems | integer | 1000 | Records in the whole run |
maxResultsPerState | integer | 10 | Records per name in each state (1–200) |
maxConcurrency | integer | 4 | Registries searched at once |
proxy | object | none | Optional; the registries normally answer without one |
Example input
{"companyNames": ["Starbucks", "Goldman Sachs"],"matchMode": "exact","states": ["FL", "TX", "NY", "CO"],"includeDetails": true,"maxResultsPerState": 5}
Colorado by registered agent:
{"agentNames": ["Corporation Service Company"],"matchMode": "exact","states": ["CO"],"maxResultsPerState": 5}
West Virginia by record id:
{"fileNumbers": ["294278"],"states": ["WV"]}
Rhode Island by identification number:
{"fileNumbers": ["000015908"],"states": ["RI"]}
Rhode Island by filing number:
{"fileNumbers": ["202689281200"],"states": ["RI"]}
Delaware by file number:
{"fileNumbers": ["4290350"],"states": ["DE"]}
Kentucky by organization number:
{"fileNumbers": ["0059256"],"states": ["KY"]}
Arkansas by filing number:
{"fileNumbers": ["100067582"],"states": ["AR"]}
North Dakota by filing number:
{"fileNumbers": ["10610"],"states": ["ND"]}
Idaho by filing number:
{"fileNumbers": ["98318"],"states": ["ID"]}
Florida by document number:
{"fileNumbers": ["112252"],"states": ["FL"]}
New York by DOS id:
{"fileNumbers": ["1701167"],"states": ["NY"]}
New York by filing number:
{"fileNumbers": ["A171209-5"],"states": ["NY"]}
Connecticut by account number:
{"fileNumbers": ["0287916"],"states": ["CT"]}
Connecticut by filing number:
{"fileNumbers": ["0005799067"],"states": ["CT"]}
Colorado by entity id:
{"fileNumbers": ["19981033526"],"states": ["CO"]}
Oregon by registry number:
{"fileNumbers": ["8739914"],"states": ["OR"]}
Pennsylvania by filing number:
{"fileNumbers": ["159516"],"states": ["PA"]}
Vermont by entity number:
{"fileNumbers": ["74657"],"states": ["VT"]}
Minnesota by file number:
{"fileNumbers": ["3834-LFC"],"states": ["MN"]}
Texas by taxpayer number, EIN or file number:
{"taxpayerNumbers": ["17424878340", "74-2487834"],"fileNumbers": ["7444706"],"states": ["TX"]}
Texas entities chartered since a date, in one city and type:
{"formedAfter": "2026-10-01","cities": ["Houston"],"entityTypes": ["LLC"],"naicsCodes": ["238"],"states": ["TX"],"maxItems": 100}
Output overview
One row per entity. Addresses share one shape (street, city, state, zip, country, full), and officers are a list of { name, title, address }. Fields a registry does not publish are null (or [] for officers), never invented. stateSpecific holds extras only some states have: FEIN, DBA, NAICS, standing, last event, renewal dates.
Output sample
{"searchQuery": "Starbucks","state": "FL","stateName": "Florida","entityName": "STARBUCKS CORPORATION","entityId": "F94000004842","entityType": "Foreign Profit Corporation","status": "ACTIVE","isActive": true,"jurisdiction": "WA","formationDate": "1994-09-20","principalAddress": {"street": "2401 Utah Avenue S.MS: S-LA1, Suite 800","city": "Seattle","state": "WA","zip": "98134-1435","country": null,"full": "2401 Utah Avenue S.MS: S-LA1, Suite 800, Seattle, WA 98134-1435"},"mailingAddress": {"street": "P.O. Box 34110","city": "Seattle","state": "WA","zip": "98124-1110","country": null,"full": "P.O. Box 34110, Seattle, WA 98124-1110"},"registeredAgent": {"name": "THE PRENTICE-HALL CORPORATION SYSTEM, INC.","address": {"street": "1201 HAYS STREET","city": "TALLAHASSEE","state": "FL","zip": "32301","country": null,"full": "1201 HAYS STREET, TALLAHASSEE, FL 32301"}},"officers": [{"name": "Ford, Beth","title": "Director","address": {"street": "2401 Utah Avenue S.MS: S-LA1, Suite 800","city": "Seattle","state": "WA","zip": "98134-1435","country": null,"full": "2401 Utah Avenue S.MS: S-LA1, Suite 800, Seattle, WA 98134-1435"}}],"stateSpecific": {"fein": "91-1325671","lastEvent": "NAME CHANGE AMENDMENT","lastEventDate": "2024-02-14"},"detailLevel": "full","sourceUrl": "https://search.sunbiz.org/Inquiry/CorporationSearch/SearchResultDetail?inquirytype=EntityName&directionType=Initial&searchNameOrder=STARBUCKS%20F940000048420&aggregateId=forp-f94000004842-98da992f-f634-4270-af0f-16cbcac4df4c&searchTerm=STARBUCKS&listNameOrder=STARBUCKS%20F940000048420","dataSource": "Florida Division of Corporations (Sunbiz)","scrapedAt": "2026-10-02T06:08:15.041Z"}
Key output fields
| Field | Description |
|---|---|
entityName | Legal name as the registry holds it |
entityId | The state's own identifier: document number (FL), SOS file number (TX), DOS ID (NY), entity ID (NJ, CO, AL, CA), account number (CT), registry number (OR), file number (MN, AR), organization number (KY), org ID (WV), record number (ID, ND), business number (IA), DFI ID (WI), filing number (PA), identification number or filing number (RI), charter number (MO) |
entityType | Entity type as the state words it, e.g. "Foreign Limited Liability Company" |
status / isActive | Status text from the registry, plus a normalized true / false / null |
jurisdiction | State or country of formation |
formationDate | Formation or registration date in that state, YYYY-MM-DD |
registeredAgent | { name, address } |
officers | [{ name, title, address }]: directors, officers, managers, members, authorized persons. Kentucky current officers have a title and a name; the registry does not print an address there |
nameHistory | Kentucky: previous names and the action, such as a merger. Florida: previous names and the filing that changed them, when the registry lists any. New York: inactive names. Colorado: the previous legal name from an entity name change. Minnesota: earlier business names. Connecticut, Rhode Island and West Virginia: earlier legal names from a name change. Omitted when that state does not publish former names on the free record |
filings | Kentucky, Florida, New York, Colorado, Connecticut, Minnesota and West Virginia: the newest filings, at most 25. Kentucky, New York, Colorado, Connecticut and Minnesota include the file date and effective date. Florida includes the filing date. West Virginia includes the amendment date; an annual report year has no month or day. Omitted when that state does not publish them |
principalAddress / mailingAddress | Address objects |
stateSpecific | Extra fields by state (FEIN, DBA, NAICS, standing, last event, renewal date) |
detailLevel | full when the detail record was read, listing when only the search row was |
sourceUrl | Link to the record at the official source |
searchQuery | The company name, registered agent, officer or street that produced this row |
Each run stores a COVERAGE record in its key-value store. It is not a billed dataset row. For every selected state it lists how many records came back, how many searches failed, and whether the free record includes officers, former names, filing activity, and UCC filings. included means the full record reads that field when the registry prints it. unavailable means this actor does not return it for that state.
FAQ
Is this data official?
Yes. Every record comes from the state's own registry or the state's own open-data portal, and sourceUrl points back to it. Registries update on their own schedule (open-data feeds are refreshed daily to weekly).
Why are some fields empty for one state and filled for another?
States publish different things. Colorado's feed has no officers. Texas publishes an organizational-type code, which comes back as wording in entityType (for example Texas limited liability company), plus county and NAICS when the register has them. New York names a registered agent only when the entity appointed one (otherwise the Secretary of State is the statutory agent and the service-of-process address is in stateSpecific).
Why did a Florida search return names that only start with my query?
Sunbiz only searches by the beginning of a name. Use startsWith or exact for predictable Florida results.
Am I charged for searches that find nothing? No. Billing is per record in the dataset. A name that matches nothing in a state costs nothing.
What happens when a state registry is down?
The other states still run. The failed name/state pairs are saved to the FAILED_SEARCHES record and named in the run status. A run where every search fails ends as FAILED.
Can I search by officer or registered agent name? Yes. Registered agent: Arkansas, Colorado, Connecticut, Florida, New York, Oregon, Rhode Island and West Virginia. Officer: Colorado, Connecticut, Florida, New York, Oregon, Pennsylvania and Rhode Island. Street: those officer states and West Virginia. Other selected states are skipped for that lookup.
Can I look up a file number? Texas takes a Secretary of State file number of 6 to 10 digits. Minnesota takes the file number as printed, such as 3834-LFC. The number 3834 stays a different company. Vermont takes an entity number, such as 74657. Leading zeros are ignored, and 7465 stays a different company. Pennsylvania takes a filing number, and 159516 matches 0000159516. Oregon takes a registry number, such as 8739914. Leading zeros are dropped, and 873991 stays a different company. Colorado takes an entity id, such as 19981033526. Leading zeros are dropped, and 1998103352 stays a different company. Connecticut takes an account number, such as 0287916. Leading zeros stay, so 287916 stays a different company, and 028791 stays a different company. Connecticut also takes a 10-digit filing number, such as 0005799067, or a filing number that starts with letters, such as BF-0010157714. 0005799068 stays a different company. The record id is the account number. New York takes a DOS id, such as 1701167. Leading zeros stay, so 01701167 stays a different number, and 170116 stays a different company. New York also takes a filing number that starts with a letter, such as A171209-5. A171209-6 stays a different filing. The result is that company, and the record id is its DOS id. Florida takes a document number, such as 112252 or L17000138980. Letters and leading zeros stay, so 11225 stays a different company, and 0112252 stays a different number. Idaho takes a filing number, such as 98318. Leading zeros are dropped, so 0000098318 is that company, and 9831 stays a different company. North Dakota takes a filing number, such as 10610. Leading zeros are dropped, so 0000010610 is that company, and 1061 stays a different company. Arkansas takes a filing number, such as 100067582. Leading zeros stay, so 0100067582 stays a different number, and 10006758 stays a different company. Kentucky takes an organization number, such as 0059256. Leading zeros are dropped, so 59256 is that company, and 005925 stays a different company. The result is the organization. Assumed names under that number are left out. Delaware takes a file number, such as 4290350. Leading zeros are dropped, so 04290350 is that company, and 429035 stays a different company. The free record has no status. Rhode Island takes a 9-digit identification number, such as 000015908. Leading zeros stay, so 15908 stays a different number, and 000001590 stays a different company. Rhode Island also takes a 12-digit filing number, such as 202689281200. 202689281201 stays a different filing, and 20268928120 stays out. That result is the company name on the filing. West Virginia takes a record id, such as 294278. Leading zeros are dropped, so 0294278 is that company, and 29427 stays a different company. Each of those states runs when it is selected.
Your feedback
If this actor saves you time, a short review on this page helps other people find it. If a state, field or search mode is missing, open an issue first: requests usually ship within days.
Support
- For issues or feature requests, please use the Issues tab of this actor on Apify Console.
- For further assistance, contact the author:
- Author's website: https://muhamed-didovic.github.io/
- Email: muhamed.didovic@gmail.com
Additional services
- Request another state, a custom field set, or a private build: muhamed.didovic@gmail.com
- Need scheduled monitoring of a company portfolio (status, agent or officer changes) delivered to your database? Contact muhamed.didovic@gmail.com
- For API services of this actor, reach out to muhamed.didovic@gmail.com
- Explore other scrapers at memo23's Apify profile
Explore More Scrapers
- Handelsregister Scraper: the official German company register with officers, representation rules and name history
- Italy Company Registry Scraper: Registro Imprese records with VAT, REA, ATECO, financials and PEC email
🤖 For AI Agents & LLM Apps
Compact reference for AI agents calling this actor via the Apify MCP server or the Apify API (actor: memo23/us-business-entity-search).
Purpose: Looks up US companies by name in official state business registries (FL, TX, NY, NJ, CO, CT, OR, MN, KY, AL, ID, WV, ND, IA, WI, PA, AR, RI, MO, and CA when caApiKey is set) and returns one normalized record per entity with status, type, formation date, registered agent, officers and addresses.
Minimal input:
{ "companyNames": ["Acme Corp"], "matchMode": "exact" }
Output: searchQuery, state, stateName, entityName, entityId, entityType, status, isActive, jurisdiction, formationDate, principalAddress, mailingAddress, registeredAgent {name, address}, officers [{name, title, address}], stateSpecific, detailLevel, sourceUrl, dataSource, scrapedAt. Address objects: street, city, state, zip, country, full.
Behaviors an agent should know:
statesempty means every no-key state. California is included only whencaApiKeyis set. Unsupported codes are skipped with a warning, never an error.- Use
matchMode: "exact"for verification (punctuation and LLC/Inc/Corp are ignored);containsfor discovery. - Florida and Iowa only support prefix search;
containscannot find a word in the middle of those names. isActiveisnullwhen the status text is ambiguous; checkstatus.includeDetails: falsereturns name, ID, type and status faster, without officers and addresses.fileNumbersaccepts a Texas SOS file number (6 to 10 digits), a Minnesota file number as printed, such as3834-LFC, a Vermont entity number, such as74657, a Pennsylvania filing number, an Oregon registry number, such as8739914, a Colorado entity id, such as19981033526, a Connecticut account number, such as0287916, a Connecticut filing number, such as0005799067, a New York DOS id, such as1701167, a New York filing number, such asA171209-5, a Florida document number, such as112252, an Idaho filing number, such as98318, a North Dakota filing number, such as10610, an Arkansas filing number, such as100067582, a Kentucky organization number, such as0059256, a Delaware file number, such as4290350, a Rhode Island identification number, such as000015908, a Rhode Island filing number, such as202689281200, and a West Virginia record id, such as294278.202689281201does not match202689281200.159516matches0000159516.15908does not match000015908.29427does not match294278.873991does not match8739914.1998103352does not match19981033526.287916does not match0287916.170116does not match1701167.11225does not match112252.9831does not match98318.1061does not match10610.10006758does not match100067582.005925does not match0059256.429035does not match4290350. Each state runs when it is selected.- Failed registries are listed in the
FAILED_SEARCHESkey-value record; a run fails only if every search fails. - Pay-per-event billing: a small actor-start fee plus one charge per record; see the Pricing tab.
⚠️ Disclaimer
This actor reads public business registration records that US state governments publish for anyone to search. It does not log in, bypass authentication, or access non-public data. You are responsible for using the data in line with each registry's terms of use and with laws that apply to you, including the FCRA, which does not allow this data to be used as a consumer report. The actor and its author are not affiliated with, endorsed by, or sponsored by any state government or Secretary of State office; agency names are used only to describe the sources the actor reads. Registry data can be out of date or incomplete; confirm critical facts with the issuing state before acting on them.
The author provides this actor "as is", without warranty of any kind, and disclaims any liability for damages arising from its use.
SEO Keywords
secretary of state business search, business entity search, us business entity lookup, sunbiz scraper, florida business search, texas business entity search, new york dos entity search, colorado business search, connecticut business registry, oregon business registry, minnesota business search, north dakota business search, new jersey business search, kentucky business search, alabama business entity search, idaho business search, west virginia business search, kyb api, kyb verification, company registration lookup, registered agent lookup, llc lookup, corporation search, company officers lookup, business verification api, state business registry scraper, company formation date lookup, entity status check, vendor due diligence, merchant onboarding verification