Home › Funding, grants and compliance › Business Entity Search
Verify business names against official Secretary of State open data for CO, NY, OR, CT, PA and TX in bulk: match score, status, formation date, registered agent, addresses, officers and source link.
| Field | Name | Required | What it does |
|---|---|---|---|
names | Company names | no | One company name per line. Each name is looked up in every selected state; legal suffixes (Inc., LLC, Corp.) and punctuation are normalised before matching. Up to 10,000 names per... |
query | Keyword search | no | Optional. Find entities whose name contains all of these words, e.g. "rocky mountain brewing". Returns up to Max results rows, best matches first. |
entityIds | Entity IDs | no | Optional. Registry IDs to fetch directly, e.g. CO:19931121425 or NY:69033 (state prefix recommended; without it every selected state is searched). TX accepts the SOS file number... |
states | States | no | Which state registries to search. Empty = all six. |
matchMode | Match mode | no | exact: same name once legal suffixes are ignored. startsWith (default): exact plus names that start with your name as whole words, e.g. "Sheetz" -> "Sheetz Bakery, Inc.".... |
maxResultsPerName | Max results per name | no | Best-scoring matches kept for each name across all states (1 to 100). |
maxResults | Max results | no | Cap on matched entity rows delivered (and charged) this run. Not-found rows do not count. |
includeInactive | Include inactive entities | no | Also return dissolved, withdrawn, revoked or forfeited entities. Only CO, CT and TX publish inactive records; NY, OR and PA open data list active entities only. |
entityTypes | Entity types | no | Keep only these types. Empty = all. |
formedAfter | Formed on or after | no | Keep entities formed or registered on or after this date (YYYY-MM-DD). |
formedBefore | Formed on or before | no | Keep entities formed or registered on or before this date (YYYY-MM-DD). |
city | City | no | Keep entities whose listed city matches (case-insensitive). Note which address each state lists: see the README coverage table. |
zip | ZIP code | no | Keep entities whose listed ZIP starts with these 5 digits. |
includeOfficers | Include officers | no | Return officer/principal names and titles where the state publishes them (CT, PA, NY chief executive). Costs one extra request per CT batch. |
One row per result. These are the 29 fields declared in the actor's dataset schema (field list from the schema, not a sample run).
| Field | Type | Meaning |
|---|---|---|
query | string | |
queryType | string | |
found | boolean | |
matchScore | number | |
matchType | string | |
state | string | |
stateName | string | |
entityId | string | |
entityName | string | |
entityType | string | |
entityTypeRaw | string | |
status | string | |
isActive | boolean | |
formationDate | string | |
jurisdictionOfFormation | string | |
registeredAgentName | string | |
registeredAgentAddress | string | |
principalAddress | string | |
mailingAddress | string | |
serviceOfProcessAddress | string | |
city | string | |
zip | string | |
county | string | |
officers | array | |
naics | string | |
taxpayerNumber | string | |
sourceRecordUrl | string | |
sourceDataset | string | |
retrievedAt | string |
Public data only, no login. Fields a source does not publish come back empty rather than guessed. Coverage and freshness follow the underlying public source.
Pay on Apify, no subscription: $0.0014 per entity record (pay per event). The live price is on the actor page.
Disclosure: we build and maintain this actor.