{
  "data": {
    "id": "KYrNb7RXr86YGAESj",
    "actId": "z5kjwPgX5t6AcMwCj",
    "userId": "tnBVjt3CXmcUrEE3L",
    "startedAt": "2026-10-31T20:23:52.131Z",
    "finishedAt": "2026-10-31T20:23:57.458Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 5257,
      "runTimeSecs": 5.257,
      "computeUnits": 0.005841111111111111,
      "imageSizeBytes": 318960640
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "F2Aeb3gE2syjqz9xC",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"New York Business Entity Search Input\",\n  \"description\": \"Search New York Department of State business entities by name, DOS ID or assumed name, or browse the active registry by agent, county, type, jurisdiction, city, officer, ZIP or state. Active, inactive and suspended statuses are supported, with optional detail and filing history.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Search mode\",\n      \"type\": \"string\",\n      \"description\": \"What to search by. Fields labelled with a mode are only used by that mode.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"byEntityName\",\n        \"byIdentificationNumber\",\n        \"byAssumedName\",\n        \"byAssumedNameId\",\n        \"byRegisteredAgent\",\n        \"byCounty\",\n        \"byEntityType\",\n        \"byJurisdiction\",\n        \"byCity\",\n        \"byOfficerName\",\n        \"byZipCode\",\n        \"byState\"\n      ],\n      \"enumTitles\": [\n        \"By entity name\",\n        \"By DOS ID number\",\n        \"By assumed name (DBA)\",\n        \"By assumed name ID\",\n        \"By registered agent name\",\n        \"By county\",\n        \"By entity type\",\n        \"By jurisdiction of formation\",\n        \"By city\",\n        \"By officer/CEO name\",\n        \"By ZIP code\",\n        \"By state\"\n      ],\n      \"default\": \"byEntityName\",\n      \"prefill\": \"byEntityName\"\n    },\n    \"entityName\": {\n      \"title\": \"Entity name (mode=byEntityName)\",\n      \"type\": \"string\",\n      \"description\": \"Legal business name to search for, e.g. `AMAZON` or `GOOGLE ACCESS`.\",\n      \"editor\": \"textfield\",\n      \"default\": \"AMAZON\",\n      \"prefill\": \"AMAZON\"\n    },\n    \"entityNameMatchType\": {\n      \"title\": \"Name match type (mode=byEntityName)\",\n      \"type\": \"string\",\n      \"description\": \"How the entity name is matched. `Exact match` is applied after the search returns.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"startsWith\",\n        \"contains\",\n        \"exact\"\n      ],\n      \"enumTitles\": [\n        \"Begins with\",\n        \"Contains\",\n        \"Exact match\"\n      ],\n      \"default\": \"startsWith\",\n      \"prefill\": \"startsWith\"\n    },\n    \"idNumbers\": {\n      \"title\": \"DOS ID number(s) (mode=byIdentificationNumber)\",\n      \"type\": \"array\",\n      \"description\": \"Exact New York DOS ID numbers. Pasted entity-page URLs are accepted.\",\n      \"editor\": \"stringList\",\n      \"prefill\": [\n        \"4087072\"\n      ]\n    },\n    \"assumedName\": {\n      \"title\": \"Assumed name / DBA (mode=byAssumedName)\",\n      \"type\": \"string\",\n      \"description\": \"Doing-business-as name to search for, e.g. `AMAZON FRESH`.\",\n      \"editor\": \"textfield\"\n    },\n    \"assumedNameMatchType\": {\n      \"title\": \"Assumed-name match type (mode=byAssumedName)\",\n      \"type\": \"string\",\n      \"description\": \"How the assumed name is matched.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"startsWith\",\n        \"contains\"\n      ],\n      \"enumTitles\": [\n        \"Begins with\",\n        \"Contains\"\n      ],\n      \"default\": \"contains\",\n      \"prefill\": \"contains\"\n    },\n    \"assumedNameId\": {\n      \"title\": \"Assumed name ID (mode=byAssumedNameId)\",\n      \"type\": \"string\",\n      \"description\": \"Exact New York assumed-name (DBA) ID, e.g. `6502000`.\",\n      \"editor\": \"textfield\"\n    },\n    \"agentName\": {\n      \"title\": \"Registered agent name (mode=byRegisteredAgent)\",\n      \"type\": \"string\",\n      \"description\": \"Registered agent name to search for, e.g. `CT CORPORATION SYSTEM`. Active entities only.\",\n      \"editor\": \"textfield\"\n    },\n    \"agentMatchType\": {\n      \"title\": \"Agent match type (mode=byRegisteredAgent)\",\n      \"type\": \"string\",\n      \"description\": \"How the registered agent name is matched.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"startsWith\",\n        \"contains\"\n      ],\n      \"enumTitles\": [\n        \"Begins with\",\n        \"Contains\"\n      ],\n      \"default\": \"contains\",\n      \"prefill\": \"contains\"\n    },\n    \"county\": {\n      \"title\": \"County (mode=byCounty)\",\n      \"type\": \"string\",\n      \"description\": \"New York county of the entity's service-of-process address. Active entities only.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"Albany\",\n        \"Allegany\",\n        \"Bronx\",\n        \"Broome\",\n        \"Cattaraugus\",\n        \"Cayuga\",\n        \"Chautauqua\",\n        \"Chemung\",\n        \"Chenango\",\n        \"Clinton\",\n        \"Columbia\",\n        \"Cortland\",\n        \"Delaware\",\n        \"Dutchess\",\n        \"Erie\",\n        \"Essex\",\n        \"Franklin\",\n        \"Fulton\",\n        \"Genesee\",\n        \"Greene\",\n        \"Hamilton\",\n        \"Herkimer\",\n        \"Jefferson\",\n        \"Kings\",\n        \"Lewis\",\n        \"Livingston\",\n        \"Madison\",\n        \"Monroe\",\n        \"Montgomery\",\n        \"Nassau\",\n        \"New York\",\n        \"Niagara\",\n        \"Oneida\",\n        \"Onondaga\",\n        \"Ontario\",\n        \"Orange\",\n        \"Orleans\",\n        \"Oswego\",\n        \"Otsego\",\n        \"Putnam\",\n        \"Queens\",\n        \"Rensselaer\",\n        \"Richmond\",\n        \"Rockland\",\n        \"Saratoga\",\n        \"Schenectady\",\n        \"Schoharie\",\n        \"Schuyler\",\n        \"Seneca\",\n        \"St. Lawrence\",\n        \"Steuben\",\n        \"Suffolk\",\n        \"Sullivan\",\n        \"Tioga\",\n        \"Tompkins\",\n        \"Ulster\",\n        \"Unknown\",\n        \"Warren\",\n        \"Washington\",\n        \"Wayne\",\n        \"Westchester\",\n        \"Wyoming\",\n        \"Yates\"\n      ],\n      \"enumTitles\": [\n        \"Albany\",\n        \"Allegany\",\n        \"Bronx\",\n        \"Broome\",\n        \"Cattaraugus\",\n        \"Cayuga\",\n        \"Chautauqua\",\n        \"Chemung\",\n        \"Chenango\",\n        \"Clinton\",\n        \"Columbia\",\n        \"Cortland\",\n        \"Delaware\",\n        \"Dutchess\",\n        \"Erie\",\n        \"Essex\",\n        \"Franklin\",\n        \"Fulton\",\n        \"Genesee\",\n        \"Greene\",\n        \"Hamilton\",\n        \"Herkimer\",\n        \"Jefferson\",\n        \"Kings (Brooklyn)\",\n        \"Lewis\",\n        \"Livingston\",\n        \"Madison\",\n        \"Monroe\",\n        \"Montgomery\",\n        \"Nassau\",\n        \"New York (Manhattan)\",\n        \"Niagara\",\n        \"Oneida\",\n        \"Onondaga\",\n        \"Ontario\",\n        \"Orange\",\n        \"Orleans\",\n        \"Oswego\",\n        \"Otsego\",\n        \"Putnam\",\n        \"Queens\",\n        \"Rensselaer\",\n        \"Richmond (Staten Island)\",\n        \"Rockland\",\n        \"Saratoga\",\n        \"Schenectady\",\n        \"Schoharie\",\n        \"Schuyler\",\n        \"Seneca\",\n        \"St. Lawrence\",\n        \"Steuben\",\n        \"Suffolk\",\n        \"Sullivan\",\n        \"Tioga\",\n        \"Tompkins\",\n        \"Ulster\",\n        \"Unknown / not recorded\",\n        \"Warren\",\n        \"Washington\",\n        \"Wayne\",\n        \"Westchester\",\n        \"Wyoming\",\n        \"Yates\"\n      ],\n      \"default\": \"New York\",\n      \"prefill\": \"New York\"\n    },\n    \"entityType\": {\n      \"title\": \"Entity type (mode=byEntityType)\",\n      \"type\": \"string\",\n      \"description\": \"Exact entity type recorded by NY DOS. Active entities only. For the broader official categories use `entityTypeCategories`.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"DOMESTIC BENEFIT CORPORATION\",\n        \"DOMESTIC BENEVOLENT ORDER\",\n        \"DOMESTIC BUSINESS CORPORATION\",\n        \"DOMESTIC CONDOMINIUM\",\n        \"DOMESTIC CONDOMINIUM DECLARATION\",\n        \"DOMESTIC COOPERATIVE CORPORATION\",\n        \"DOMESTIC COOPERATIVE CORPORATION (WORKER COOPERATIVE)\",\n        \"DOMESTIC DESIGN PROFESSIONAL SERVICE CORPORATION\",\n        \"DOMESTIC GENERAL ASSOCIATION\",\n        \"DOMESTIC GOVERNMENTAL AGENCY\",\n        \"DOMESTIC HOUSING DEVELOPMENT FUND COMPANY (ARTICLE XI)\",\n        \"DOMESTIC JOINT STOCK ASSOCIATION\",\n        \"DOMESTIC LIMITED LIABILITY COMPANY\",\n        \"DOMESTIC LIMITED PARTNERSHIP\",\n        \"DOMESTIC LIMITED-PROFIT HOUSING COMPANY (ARTICLE 2 PHFL & BCL)\",\n        \"DOMESTIC LIMITED-PROFIT HOUSING COMPANY (ARTICLE 2 PHFL & NPCL)\",\n        \"DOMESTIC NOT-FOR-PROFIT CORPORATION\",\n        \"DOMESTIC NOT-FOR-PROFIT CORPORATION (BOARD OF TRADE AND CHAMBER OF COMMERCE CORPORATION)\",\n        \"DOMESTIC NOT-FOR-PROFIT CORPORATION (COMMUNITY MENTAL HEALTH SERVICES AND MENTAL RETARDATION SERVICES COMPANIES)\",\n        \"DOMESTIC NOT-FOR-PROFIT CORPORATION (FIRE CORPORATION)\",\n        \"DOMESTIC NOT-FOR-PROFIT CORPORATION (HOUSING DEVELOPMENT FUND COMPANY) (ARTICLE XI)\",\n        \"DOMESTIC NOT-FOR-PROFIT CORPORATION (LAND BANK)\",\n        \"DOMESTIC NOT-FOR-PROFIT CORPORATION (LOCAL DEVELOPMENT CORPORATION)\",\n        \"DOMESTIC NOT-FOR-PROFIT CORPORATION (MILITIA ASSOCIATION)\",\n        \"DOMESTIC NOT-FOR-PROFIT CORPORATION (PUBLIC CEMETERY CORPORATION)\",\n        \"DOMESTIC NOT-FOR-PROFIT CORPORATION (UNIVERSITY FACULTY PRACTICE CORPORATION)\",\n        \"DOMESTIC PROFESSIONAL SERVICE CORPORATION\",\n        \"DOMESTIC PROFESSIONAL SERVICE LIMITED LIABILITY COMPANY\",\n        \"DOMESTIC PUBLIC BENEFIT CORPORATION\",\n        \"DOMESTIC RAILROAD CORPORATION\",\n        \"DOMESTIC REDEVELOPMENT COMPANY (ARTICLE V)\",\n        \"DOMESTIC REDEVELOPMENT COMPANY (LIMITED LIABILITY COMPANY)\",\n        \"DOMESTIC REDEVELOPMENT COMPANY (LIMITED PARTNERSHIP)\",\n        \"DOMESTIC REGISTERED LIMITED LIABILITY PARTNERSHIP\",\n        \"DOMESTIC RELIGIOUS CORPORATION\",\n        \"DOMESTIC RELIGIOUS CORPORATION (GOVERNING OR ADVISORY BODY)\",\n        \"DOMESTIC TRANSPORTATION CORPORATION\",\n        \"FOREIGN BUSINESS CORPORATION\",\n        \"FOREIGN COOPERATIVE CORPORATION\",\n        \"FOREIGN DESIGNATION OF THE SECRETARY OF STATE\",\n        \"FOREIGN GENERAL ASSOCIATION\",\n        \"FOREIGN LIMITED LIABILITY COMPANY\",\n        \"FOREIGN LIMITED PARTNERSHIP\",\n        \"FOREIGN NOT-FOR-PROFIT CORPORATION\",\n        \"FOREIGN PROFESSIONAL SERVICE CORPORATION\",\n        \"FOREIGN PROFESSIONAL SERVICE LIMITED LIABILITY COMPANY\",\n        \"FOREIGN RELIGIOUS CORPORATION\",\n        \"GENERAL ASSOCIATION DESIGNATION\",\n        \"NEW YORK REGISTERED FOREIGN LIMITED LIABILITY PARTNERSHIP\",\n        \"RESERVATION OF DOMESTIC LIMITED LIABILITY COMPANY\",\n        \"UNAUTHORIZED BUSINESS CORPORATION\",\n        \"UNAUTHORIZED FOREIGN BUSINESS CORPORATION\",\n        \"UNAUTHORIZED FOREIGN LIMITED LIABILITY COMPANY\"\n      ],\n      \"enumTitles\": [\n        \"Domestic Benefit Corporation\",\n        \"Domestic Benevolent Order\",\n        \"Domestic Business Corporation\",\n        \"Domestic Condominium\",\n        \"Domestic Condominium Declaration\",\n        \"Domestic Cooperative Corporation\",\n        \"Domestic Cooperative Corporation (Worker Cooperative)\",\n        \"Domestic Design Professional Service Corporation\",\n        \"Domestic General Association\",\n        \"Domestic Governmental Agency\",\n        \"Domestic Housing Development Fund Company (Article XI)\",\n        \"Domestic Joint Stock Association\",\n        \"Domestic Limited Liability Company\",\n        \"Domestic Limited Partnership\",\n        \"Domestic Limited-Profit Housing Company (Article 2 PHFL & BCL)\",\n        \"Domestic Limited-Profit Housing Company (Article 2 PHFL & NPCL)\",\n        \"Domestic Not-for-Profit Corporation\",\n        \"Domestic Not-for-Profit Corp. (Board of Trade and Chamber of Commerce)\",\n        \"Domestic Not-for-Profit Corp. (Community Mental Health Services)\",\n        \"Domestic Not-for-Profit Corp. (Fire Corporation)\",\n        \"Domestic Not-for-Profit Corp. (Housing Dev. Fund Co., Article XI)\",\n        \"Domestic Not-for-Profit Corp. (Land Bank)\",\n        \"Domestic Not-for-Profit Corp. (Local Development Corporation)\",\n        \"Domestic Not-for-Profit Corp. (Militia Association)\",\n        \"Domestic Not-for-Profit Corp. (Public Cemetery Corporation)\",\n        \"Domestic Not-for-Profit Corp. (University Faculty Practice)\",\n        \"Domestic Professional Service Corporation\",\n        \"Domestic Professional Service Limited Liability Company\",\n        \"Domestic Public Benefit Corporation\",\n        \"Domestic Railroad Corporation\",\n        \"Domestic Redevelopment Company (Article V)\",\n        \"Domestic Redevelopment Company (Limited Liability Company)\",\n        \"Domestic Redevelopment Company (Limited Partnership)\",\n        \"Domestic Registered Limited Liability Partnership\",\n        \"Domestic Religious Corporation\",\n        \"Domestic Religious Corporation (Governing or Advisory Body)\",\n        \"Domestic Transportation Corporation\",\n        \"Foreign Business Corporation\",\n        \"Foreign Cooperative Corporation\",\n        \"Foreign Designation of the Secretary of State\",\n        \"Foreign General Association\",\n        \"Foreign Limited Liability Company\",\n        \"Foreign Limited Partnership\",\n        \"Foreign Not-for-Profit Corporation\",\n        \"Foreign Professional Service Corporation\",\n        \"Foreign Professional Service Limited Liability Company\",\n        \"Foreign Religious Corporation\",\n        \"General Association Designation\",\n        \"New York Registered Foreign Limited Liability Partnership\",\n        \"Reservation of Domestic Limited Liability Company\",\n        \"Unauthorized Business Corporation\",\n        \"Unauthorized Foreign Business Corporation\",\n        \"Unauthorized Foreign Limited Liability Company\"\n      ],\n      \"default\": \"DOMESTIC LIMITED LIABILITY COMPANY\",\n      \"prefill\": \"DOMESTIC LIMITED LIABILITY COMPANY\"\n    },\n    \"jurisdiction\": {\n      \"title\": \"Jurisdiction of formation (mode=byJurisdiction)\",\n      \"type\": \"string\",\n      \"description\": \"State, territory, province or country where the entity was originally formed. Active entities only.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"Alabama\",\n        \"Alaska\",\n        \"Alberta\",\n        \"American Samoa\",\n        \"Arizona\",\n        \"Arkansas\",\n        \"Armed Forces (Africa, Canada, Europe, Middle East)\",\n        \"Armed Forces Pacific\",\n        \"British Columbia\",\n        \"CANAL ZONE\",\n        \"CAROLINE ISLANDS\",\n        \"California\",\n        \"Colorado\",\n        \"Connecticut\",\n        \"Delaware\",\n        \"District of Columbia\",\n        \"ENGLAND\",\n        \"ENGLAND-WALES\",\n        \"FEDERATED STATES OF MICRONESIA\",\n        \"Florida\",\n        \"Georgia\",\n        \"Guam\",\n        \"Hawaii\",\n        \"Idaho\",\n        \"Illinois\",\n        \"Indiana\",\n        \"Iowa\",\n        \"Kansas\",\n        \"Kentucky\",\n        \"Louisiana\",\n        \"MARSHALL ISLANDS\",\n        \"Maine\",\n        \"Manitoba\",\n        \"Maryland\",\n        \"Massachusetts\",\n        \"Michigan\",\n        \"Minnesota\",\n        \"Mississippi\",\n        \"Missouri\",\n        \"Montana\",\n        \"NEWFOUNDLAND\",\n        \"NORTHERN IRELAND\",\n        \"NORTHWEST TERRITORIES\",\n        \"NUNAVUT\",\n        \"Nebraska\",\n        \"Nevada\",\n        \"New Brunswick\",\n        \"New Hampshire\",\n        \"New Jersey\",\n        \"New Mexico\",\n        \"New York\",\n        \"North Carolina\",\n        \"North Dakota\",\n        \"Nova Scotia\",\n        \"Ohio\",\n        \"Oklahoma\",\n        \"Ontario\",\n        \"Oregon\",\n        \"PALAU\",\n        \"PRINCE EDWARD ISLAND\",\n        \"Pennsylvania\",\n        \"Puerto Rico\",\n        \"QUEBEC\",\n        \"Rhode Island\",\n        \"SASKATCHEWAN\",\n        \"SCOTLAND\",\n        \"South Carolina\",\n        \"South Dakota\",\n        \"Tennessee\",\n        \"Texas\",\n        \"U.S. Minor Outlying Islands\",\n        \"U.S. Virgin Islands\",\n        \"Utah\",\n        \"Vermont\",\n        \"Virginia\",\n        \"WAKE ISLAND\",\n        \"WALES\",\n        \"Washington\",\n        \"West Virginia\",\n        \"Wisconsin\",\n        \"Wyoming\"\n      ],\n      \"enumTitles\": [\n        \"Alabama\",\n        \"Alaska\",\n        \"Alberta\",\n        \"American Samoa\",\n        \"Arizona\",\n        \"Arkansas\",\n        \"Armed Forces (Africa, Canada, Europe, Middle East)\",\n        \"Armed Forces Pacific\",\n        \"British Columbia\",\n        \"Canal Zone\",\n        \"Caroline Islands\",\n        \"California\",\n        \"Colorado\",\n        \"Connecticut\",\n        \"Delaware\",\n        \"District of Columbia\",\n        \"England\",\n        \"England and Wales\",\n        \"Federated States of Micronesia\",\n        \"Florida\",\n        \"Georgia\",\n        \"Guam\",\n        \"Hawaii\",\n        \"Idaho\",\n        \"Illinois\",\n        \"Indiana\",\n        \"Iowa\",\n        \"Kansas\",\n        \"Kentucky\",\n        \"Louisiana\",\n        \"Marshall Islands\",\n        \"Maine\",\n        \"Manitoba\",\n        \"Maryland\",\n        \"Massachusetts\",\n        \"Michigan\",\n        \"Minnesota\",\n        \"Mississippi\",\n        \"Missouri\",\n        \"Montana\",\n        \"Newfoundland\",\n        \"Northern Ireland\",\n        \"Northwest Territories\",\n        \"Nunavut\",\n        \"Nebraska\",\n        \"Nevada\",\n        \"New Brunswick\",\n        \"New Hampshire\",\n        \"New Jersey\",\n        \"New Mexico\",\n        \"New York\",\n        \"North Carolina\",\n        \"North Dakota\",\n        \"Nova Scotia\",\n        \"Ohio\",\n        \"Oklahoma\",\n        \"Ontario\",\n        \"Oregon\",\n        \"Palau\",\n        \"Prince Edward Island\",\n        \"Pennsylvania\",\n        \"Puerto Rico\",\n        \"Quebec\",\n        \"Rhode Island\",\n        \"Saskatchewan\",\n        \"Scotland\",\n        \"South Carolina\",\n        \"South Dakota\",\n        \"Tennessee\",\n        \"Texas\",\n        \"U.S. Minor Outlying Islands\",\n        \"U.S. Virgin Islands\",\n        \"Utah\",\n        \"Vermont\",\n        \"Virginia\",\n        \"Wake Island\",\n        \"Wales\",\n        \"Washington\",\n        \"West Virginia\",\n        \"Wisconsin\",\n        \"Wyoming\"\n      ],\n      \"default\": \"Delaware\",\n      \"prefill\": \"Delaware\"\n    },\n    \"city\": {\n      \"title\": \"City (mode=byCity)\",\n      \"type\": \"string\",\n      \"description\": \"City of the service-of-process address, e.g. `BROOKLYN`. Active entities only.\",\n      \"editor\": \"textfield\",\n      \"default\": \"BROOKLYN\",\n      \"prefill\": \"BROOKLYN\"\n    },\n    \"cityMatchType\": {\n      \"title\": \"City match type (mode=byCity)\",\n      \"type\": \"string\",\n      \"description\": \"How the city is matched.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"startsWith\",\n        \"contains\"\n      ],\n      \"enumTitles\": [\n        \"Begins with\",\n        \"Contains\"\n      ],\n      \"default\": \"startsWith\",\n      \"prefill\": \"startsWith\"\n    },\n    \"officerName\": {\n      \"title\": \"Officer/CEO name (mode=byOfficerName)\",\n      \"type\": \"string\",\n      \"description\": \"Officer, chairman or CEO name on file. Active entities only. Populated for a minority of entities.\",\n      \"editor\": \"textfield\"\n    },\n    \"officerMatchType\": {\n      \"title\": \"Officer match type (mode=byOfficerName)\",\n      \"type\": \"string\",\n      \"description\": \"How the officer name is matched.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"startsWith\",\n        \"contains\"\n      ],\n      \"enumTitles\": [\n        \"Begins with\",\n        \"Contains\"\n      ],\n      \"default\": \"contains\",\n      \"prefill\": \"contains\"\n    },\n    \"zipCode\": {\n      \"title\": \"ZIP code (mode=byZipCode)\",\n      \"type\": \"string\",\n      \"description\": \"5-digit ZIP of the service-of-process address, e.g. `10001`. ZIP+4 is accepted and truncated. Active entities only.\",\n      \"editor\": \"textfield\",\n      \"default\": \"10001\",\n      \"prefill\": \"10001\"\n    },\n    \"state\": {\n      \"title\": \"State (mode=byState)\",\n      \"type\": \"string\",\n      \"description\": \"2-letter state/territory code of the service-of-process address (not the formation jurisdiction). Active entities only.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"AL\",\n        \"AK\",\n        \"AZ\",\n        \"AR\",\n        \"CA\",\n        \"CO\",\n        \"CT\",\n        \"DE\",\n        \"DC\",\n        \"FL\",\n        \"GA\",\n        \"HI\",\n        \"ID\",\n        \"IL\",\n        \"IN\",\n        \"IA\",\n        \"KS\",\n        \"KY\",\n        \"LA\",\n        \"ME\",\n        \"MD\",\n        \"MA\",\n        \"MI\",\n        \"MN\",\n        \"MS\",\n        \"MO\",\n        \"MT\",\n        \"NE\",\n        \"NV\",\n        \"NH\",\n        \"NJ\",\n        \"NM\",\n        \"NY\",\n        \"NC\",\n        \"ND\",\n        \"OH\",\n        \"OK\",\n        \"OR\",\n        \"PA\",\n        \"RI\",\n        \"SC\",\n        \"SD\",\n        \"TN\",\n        \"TX\",\n        \"UT\",\n        \"VT\",\n        \"VA\",\n        \"WA\",\n        \"WV\",\n        \"WI\",\n        \"WY\",\n        \"AS\",\n        \"GU\",\n        \"MP\",\n        \"PR\",\n        \"VI\",\n        \"AE\",\n        \"AA\",\n        \"AP\",\n        \"MH\",\n        \"PW\",\n        \"CZ\",\n        \"MW\",\n        \"NA\",\n        \"WK\"\n      ],\n      \"enumTitles\": [\n        \"Alabama\",\n        \"Alaska\",\n        \"Arizona\",\n        \"Arkansas\",\n        \"California\",\n        \"Colorado\",\n        \"Connecticut\",\n        \"Delaware\",\n        \"District of Columbia\",\n        \"Florida\",\n        \"Georgia\",\n        \"Hawaii\",\n        \"Idaho\",\n        \"Illinois\",\n        \"Indiana\",\n        \"Iowa\",\n        \"Kansas\",\n        \"Kentucky\",\n        \"Louisiana\",\n        \"Maine\",\n        \"Maryland\",\n        \"Massachusetts\",\n        \"Michigan\",\n        \"Minnesota\",\n        \"Mississippi\",\n        \"Missouri\",\n        \"Montana\",\n        \"Nebraska\",\n        \"Nevada\",\n        \"New Hampshire\",\n        \"New Jersey\",\n        \"New Mexico\",\n        \"New York\",\n        \"North Carolina\",\n        \"North Dakota\",\n        \"Ohio\",\n        \"Oklahoma\",\n        \"Oregon\",\n        \"Pennsylvania\",\n        \"Rhode Island\",\n        \"South Carolina\",\n        \"South Dakota\",\n        \"Tennessee\",\n        \"Texas\",\n        \"Utah\",\n        \"Vermont\",\n        \"Virginia\",\n        \"Washington\",\n        \"West Virginia\",\n        \"Wisconsin\",\n        \"Wyoming\",\n        \"American Samoa\",\n        \"Guam\",\n        \"Northern Mariana Islands\",\n        \"Puerto Rico\",\n        \"U.S. Virgin Islands\",\n        \"Armed Forces Europe/Canada/Middle East (AE)\",\n        \"Armed Forces Americas (AA)\",\n        \"Armed Forces Pacific (AP)\",\n        \"Marshall Islands\",\n        \"Palau\",\n        \"Canal Zone\",\n        \"MW (midway / other)\",\n        \"NA (not assigned)\",\n        \"WK (Wake Island)\"\n      ],\n      \"default\": \"NY\",\n      \"prefill\": \"NY\"\n    },\n    \"entityStatus\": {\n      \"title\": \"Entity status (official modes)\",\n      \"type\": \"string\",\n      \"description\": \"Filter by live DOS status: active, inactive or suspended. Applies to name, assumed-name and assumed-name ID searches. DOS-ID lookups always return the entity's real status. Legacy active-only browse modes ignore it.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"AllStatuses\",\n        \"Active\",\n        \"Inactive\",\n        \"Suspended\"\n      ],\n      \"enumTitles\": [\n        \"All statuses\",\n        \"Active\",\n        \"Inactive\",\n        \"Suspended\"\n      ],\n      \"default\": \"Active\",\n      \"prefill\": \"Active\"\n    },\n    \"entityTypeCategories\": {\n      \"title\": \"Entity type categories (official modes)\",\n      \"type\": \"array\",\n      \"description\": \"Limit official name/assumed-name searches to one or more of the four DOS categories. Leave empty for all.\",\n      \"editor\": \"select\",\n      \"items\": {\n        \"type\": \"string\",\n        \"enum\": [\n          \"Corporation\",\n          \"LimitedLiabilityCompany\",\n          \"LimitedPartnership\",\n          \"LimitedLiabilityPartnership\"\n        ],\n        \"enumTitles\": [\n          \"Corporation\",\n          \"Limited liability company\",\n          \"Limited partnership\",\n          \"Limited liability partnership\"\n        ]\n      },\n      \"prefill\": [],\n      \"uniqueItems\": true,\n      \"default\": []\n    },\n    \"includeDetails\": {\n      \"title\": \"Include full entity detail\",\n      \"type\": \"boolean\",\n      \"description\": \"Fetch each entity's detail record (section of law, CEO, stock, statement status, addresses, e-service). Adds one request per record.\",\n      \"default\": true,\n      \"prefill\": false\n    },\n    \"includeHistory\": {\n      \"title\": \"Include filing and name history\",\n      \"type\": \"boolean\",\n      \"description\": \"Fetch name, filing, merger and assumed-name history for each record. Adds up to four requests per record.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"sortBy\": {\n      \"title\": \"Sort results\",\n      \"type\": \"string\",\n      \"description\": \"Order of the emitted records. `Source order` keeps the order returned by the registry.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"source\",\n        \"newest\",\n        \"oldest\",\n        \"name\"\n      ],\n      \"enumTitles\": [\n        \"Source order\",\n        \"Newest first\",\n        \"Oldest first\",\n        \"Name A-Z\"\n      ],\n      \"default\": \"source\",\n      \"prefill\": \"source\"\n    },\n    \"searchTerms\": {\n      \"title\": \"Additional search terms\",\n      \"type\": \"array\",\n      \"description\": \"Extra names or DOS IDs searched in the same run and merged with the main term. Applies to name, assumed-name and DOS-ID modes.\",\n      \"editor\": \"stringList\"\n    },\n    \"formationDateFrom\": {\n      \"title\": \"Formation date from (all modes)\",\n      \"type\": \"string\",\n      \"description\": \"Only include entities formed/registered on or after this date (`YYYY-MM-DD`).\",\n      \"editor\": \"textfield\"\n    },\n    \"formationDateTo\": {\n      \"title\": \"Formation date to (all modes)\",\n      \"type\": \"string\",\n      \"description\": \"Only include entities formed/registered on or before this date (`YYYY-MM-DD`).\",\n      \"editor\": \"textfield\"\n    },\n    \"maxItems\": {\n      \"title\": \"Max items\",\n      \"type\": \"integer\",\n      \"description\": \"Hard cap on emitted records (1-5000).\",\n      \"minimum\": 1,\n      \"maximum\": 5000,\n      \"default\": 25,\n      \"prefill\": 1\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# New York Business Entity Search & Filing History\n\nSearch the **New York Department of State** business registry by legal name, DOS ID number or assumed name (DBA). The actor returns live active, inactive and suspended entities with their registration details, registered agent, CEO and addresses, stock information, and optional name, filing, merger and assumed-name history. No login, account or proxy is required.\n\n## What this actor does\n\n- **12 search modes:** entity name, DOS ID, assumed name, assumed name ID, registered agent, county, entity type, jurisdiction of formation, city, officer/CEO, ZIP code and service-of-process state\n- **Live status:** active, inactive and suspended entities, with status dates and the reason recorded by the Department of State\n- **Full detail:** section of law, statement status and next due date, service-of-process and principal-office addresses, CEO, registered agent, e-service status, foreign formation details and stock/share information\n- **Optional history:** name changes, filing timeline, mergers and assumed names for every record\n- **Agency and location coverage:** registered agent, officer and business-location fields are merged in for active entities when the state's open-data feed carries them\n- **Filtering and ordering:** entity-type categories, formation-date range, multiple search terms and newest / oldest / name sorting\n- **Empty fields are omitted** — records never contain nulls or placeholder values\n\n## Data source and limitations\n\nThe records come from the New York Department of State's public business-entity registry and its official open-data publication of active corporations. Entity names, DOS IDs and statuses are informational, not certified. For a certified Certificate of Status or certified copies, order them from the Department of State.\n\n- **300-row search cap:** each name search returns at most 300 rows. Broad terms are automatically split by status, entity-type category and name prefix, but an extremely broad term can still be partial. Narrow the term or use a longer prefix for complete coverage.\n- **Active-only browse modes:** registered agent, county, exact entity type, jurisdiction, city, officer, ZIP and state browsing cover active entities only. Use name, assumed-name or DOS-ID search to reach inactive and suspended entities.\n- **Sparse fields:** CEO, registered agent and business-location information are on file for a minority of entities, and the open-data feed covers active entities only, so those fields are less common on inactive records. They are omitted when absent rather than shown as blank.\n- **No documents:** filing history lists document type, date, file number, page count and amendment notes. The actor does not download filing PDFs or images.\n\n## Output per entity\n\n**Identity and status**\n\n- `entityName` — legal entity name\n- `idNumber` — New York DOS ID number\n- `entityType` — exact entity type, e.g. `DOMESTIC LIMITED LIABILITY COMPANY`\n- `entityTypeCategory` — `CORPORATION`, `LIMITED LIABILITY COMPANY`, `LIMITED PARTNERSHIP` or `LIMITED LIABILITY PARTNERSHIP` (derived from the exact entity type when the source omits it)\n- `nameType` — `ACTUAL` or `ASSUMED NAME`\n- `status` — `Active`, `Inactive` or `Suspended`\n- `formationDate` — original DOS filing date (`YYYY-MM-DD`)\n- `effectiveFilingDate` — effective date of the initial filing\n- `county`, `counties` — county (or counties, for a multi-county assumed name)\n- `jurisdiction` — state, province or country of formation\n- `assumedName`, `assumedNameId` — DBA name and its ID\n- `publicUrl` — a public company-registry page for the DOS ID (OpenCorporates)\n\n**Registration detail** *(with `includeDetails`)*\n\n- `sectionOfLaw` — section of law the entity is registered under\n- `statementStatus`, `nextStatementDueDate` — biennial-statement status and due date\n- `inactiveDate`, `reasonForStatus` — when and why the entity became inactive\n- `foreignFormationDate`, `foreignLegalName`, `fictitiousName`\n- `durationDate`, `latestDissolutionDate`, `nfpCategory`, `farmCorpFlag`\n- `serviceOfProcessName`, `serviceOfProcessAddress` — who receives legal process, with a structured address\n- `principalAddress`, `principalCity`, `principalState`, `principalZip`\n- `principalExecutiveAddress` — principal executive office, structured\n- `ceoName`, `ceoAddress` — chief executive officer on file\n- `registeredAgentName`, `registeredAgentAddress` — registered agent\n- `officerName`, `officerAddress` — chairman/CEO on file\n- `businessLocationName`, `businessLocationAddress`, `locationName`, `locationAddress`\n- `electronicServiceOfProcessStatus`, `electronicServiceOfProcessEmail`\n- `stockShares[]` — `{stockType, parValue, quantity}`\n\n**History** *(with `includeHistory`)*\n\n- `nameHistory[]` — `{entityName, documentType, fileDate, fileNumber}`\n- `filingHistory[]` — `{documentType, amendmentDescription, fileDate, fileNumber, pageCount}`\n- `mergerHistory[]` — `{documentType, survivorResultEntity, constituents, fileDate, fileNumber}`\n- `assumedNames[]` — `{assumedName, assumedNameId, status, fileDate}`\n\n**Metadata**\n\n- `sourceUrl` — the entity's record in the state's open-data feed (active entities)\n- `recordType: \"entity\"`, `scrapedAt`\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `byEntityName` | One of the 12 search modes |\n| `entityName` | string | `AMAZON` | Legal name (mode=byEntityName) |\n| `entityNameMatchType` | string | `startsWith` | `startsWith` / `contains` / `exact` |\n| `idNumbers` | array | – | DOS ID numbers; entity-page URLs accepted |\n| `assumedName` | string | – | DBA name (mode=byAssumedName) |\n| `assumedNameMatchType` | string | `contains` | `startsWith` / `contains` |\n| `assumedNameId` | string | – | Exact DBA ID (mode=byAssumedNameId) |\n| `agentName` | string | – | Registered agent (mode=byRegisteredAgent, active only) |\n| `agentMatchType` | string | `contains` | `startsWith` / `contains` |\n| `county` | string | `New York` | One of the 62 NY counties (mode=byCounty, active only) |\n| `entityType` | string | `DOMESTIC LIMITED LIABILITY COMPANY` | Exact entity type (mode=byEntityType, active only) |\n| `jurisdiction` | string | `Delaware` | Formation jurisdiction (mode=byJurisdiction, active only) |\n| `city` | string | `BROOKLYN` | Service-of-process city (mode=byCity, active only) |\n| `cityMatchType` | string | `startsWith` | `startsWith` / `contains` |\n| `officerName` | string | – | Officer/CEO (mode=byOfficerName, active only) |\n| `officerMatchType` | string | `contains` | `startsWith` / `contains` |\n| `zipCode` | string | `10001` | Service-of-process ZIP (mode=byZipCode, active only) |\n| `state` | string | `NY` | Service-of-process state code (mode=byState, active only) |\n| `entityStatus` | string | `Active` | `AllStatuses` / `Active` / `Inactive` / `Suspended` (official name and assumed-name modes) |\n| `entityTypeCategories` | array | all | Any of the four DOS categories |\n| `includeDetails` | boolean | `true` | Fetch the full registration detail |\n| `includeHistory` | boolean | `false` | Fetch name, filing, merger and assumed-name history |\n| `sortBy` | string | `source` | `source` / `newest` / `oldest` / `name` |\n| `searchTerms` | array | – | Extra names or DOS IDs searched in the same run |\n| `formationDateFrom` | string | – | `YYYY-MM-DD`, all modes |\n| `formationDateTo` | string | – | `YYYY-MM-DD`, all modes |\n| `maxItems` | int | `25` | Hard cap (1–5000) |\n\n### Example: inactive entities with full history\n\n```json\n{\n  \"mode\": \"byEntityName\",\n  \"entityName\": \"AMAZON\",\n  \"entityNameMatchType\": \"contains\",\n  \"entityStatus\": \"Inactive\",\n  \"includeDetails\": true,\n  \"includeHistory\": true,\n  \"maxItems\": 25\n}\n```\n\n### Example: find every business using a DBA\n\n```json\n{\n  \"mode\": \"byAssumedName\",\n  \"assumedName\": \"AMAZON FRESH\",\n  \"assumedNameMatchType\": \"contains\",\n  \"entityStatus\": \"AllStatuses\",\n  \"includeDetails\": true,\n  \"maxItems\": 25\n}\n```\n\n### Example: look up specific DOS IDs\n\n```json\n{\n  \"mode\": \"byIdentificationNumber\",\n  \"idNumbers\": [\"4809335\", \"4282851\", \"5561845\"],\n  \"includeDetails\": true,\n  \"includeHistory\": true\n}\n```\n\n### Example: browse active entities by county and date\n\n```json\n{\n  \"mode\": \"byCounty\",\n  \"county\": \"Kings\",\n  \"formationDateFrom\": \"2024-01-01\",\n  \"formationDateTo\": \"2024-12-31\",\n  \"sortBy\": \"newest\",\n  \"maxItems\": 100\n}\n```\n\n### Example: foreign entities formed in England\n\n```json\n{\n  \"mode\": \"byJurisdiction\",\n  \"jurisdiction\": \"ENGLAND\",\n  \"maxItems\": 50\n}\n```\n\n## Use cases\n\n- **Due diligence and KYC** — confirm legal name, DOS ID, formation date and current status before signing or onboarding a vendor\n- **Compliance and litigation research** — trace prior names, mergers and filing history for a New York entity\n- **Registered-agent research** — find the active entities a specific agent represents in New York\n- **DBA and brand research** — find the legal entity behind a storefront, brand or trade name\n- **Lead lists** — build active-business lists by county, ZIP code, entity type or formation date\n- **Name availability** — check existing names and DBAs before forming a new entity\n\n## FAQ\n\n**Where does the data come from?** The New York Department of State's public business-entity registry, plus its official open-data publication of active corporations. This is an independent tool and is not affiliated with the State of New York.\n\n**Is this data official or legally binding?** No. It is the same free informational data the Department of State publishes. For a certified Certificate of Status or certified copies, order them from the Department of State.\n\n**What do the statuses mean?** `Active` means the entity is current with the Department of State. `Inactive` means it was dissolved, terminated or otherwise ended, and `Suspended` means it is not in good standing. The `reasonForStatus` and `inactiveDate` fields explain an inactive record.\n\n**Why did my broad name search stop at 300 rows?** The state search returns at most 300 rows per query. The actor automatically splits broad searches by status, entity-type category and name prefix, but a very broad term can still be partial. Use a longer prefix or a narrower term.\n\n**Why are agent, CEO or business-location fields missing on some records?** Those fields are on file for only a minority of entities. The active-only open-data feed adds them for some active entities; inactive records usually only carry the official registration detail. Missing fields are omitted, never shown as blank.\n\n**Why does `exact` return fewer results than expected?** Exact mode filters the candidates returned by the state search. If the prefix itself is capped at 300 rows, the exact entity may not be among the returned candidates; use a full name with `startsWith` or reset the status filter.\n\n**How fresh is the data?** Status, detail and history come from the live registry. The supplementary agent/location feed is refreshed periodically by the state, so those fields can lag the live record.\n\n**Does history include filing documents?** No. History lists document type, date, file number, page count and amendment notes. Filing PDFs and images are ordered separately from the Department of State.\n\n**Do I need an API key or proxy?** No. The actor works out of the box with no account, key, cookie or proxy configuration.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "new-york-dos-business-entity-registry-lookup",
      "title": "New York Business Entity Search & Filing History",
      "description": "Search New York DOS business entities by name, DOS ID or assumed name. Get active, inactive and suspended status, agents, CEO, addresses, stock and filing history. No login or proxy.",
      "version": "1.1",
      "buildTag": "latest",
      "dockerfile": "./Dockerfile",
      "readme": "# New York Business Entity Search & Filing History\n\nSearch the **New York Department of State** business registry by legal name, DOS ID number or assumed name (DBA). The actor returns live active, inactive and suspended entities with their registration details, registered agent, CEO and addresses, stock information, and optional name, filing, merger and assumed-name history. No login, account or proxy is required.\n\n## What this actor does\n\n- **12 search modes:** entity name, DOS ID, assumed name, assumed name ID, registered agent, county, entity type, jurisdiction of formation, city, officer/CEO, ZIP code and service-of-process state\n- **Live status:** active, inactive and suspended entities, with status dates and the reason recorded by the Department of State\n- **Full detail:** section of law, statement status and next due date, service-of-process and principal-office addresses, CEO, registered agent, e-service status, foreign formation details and stock/share information\n- **Optional history:** name changes, filing timeline, mergers and assumed names for every record\n- **Agency and location coverage:** registered agent, officer and business-location fields are merged in for active entities when the state's open-data feed carries them\n- **Filtering and ordering:** entity-type categories, formation-date range, multiple search terms and newest / oldest / name sorting\n- **Empty fields are omitted** — records never contain nulls or placeholder values\n\n## Data source and limitations\n\nThe records come from the New York Department of State's public business-entity registry and its official open-data publication of active corporations. Entity names, DOS IDs and statuses are informational, not certified. For a certified Certificate of Status or certified copies, order them from the Department of State.\n\n- **300-row search cap:** each name search returns at most 300 rows. Broad terms are automatically split by status, entity-type category and name prefix, but an extremely broad term can still be partial. Narrow the term or use a longer prefix for complete coverage.\n- **Active-only browse modes:** registered agent, county, exact entity type, jurisdiction, city, officer, ZIP and state browsing cover active entities only. Use name, assumed-name or DOS-ID search to reach inactive and suspended entities.\n- **Sparse fields:** CEO, registered agent and business-location information are on file for a minority of entities, and the open-data feed covers active entities only, so those fields are less common on inactive records. They are omitted when absent rather than shown as blank.\n- **No documents:** filing history lists document type, date, file number, page count and amendment notes. The actor does not download filing PDFs or images.\n\n## Output per entity\n\n**Identity and status**\n\n- `entityName` — legal entity name\n- `idNumber` — New York DOS ID number\n- `entityType` — exact entity type, e.g. `DOMESTIC LIMITED LIABILITY COMPANY`\n- `entityTypeCategory` — `CORPORATION`, `LIMITED LIABILITY COMPANY`, `LIMITED PARTNERSHIP` or `LIMITED LIABILITY PARTNERSHIP` (derived from the exact entity type when the source omits it)\n- `nameType` — `ACTUAL` or `ASSUMED NAME`\n- `status` — `Active`, `Inactive` or `Suspended`\n- `formationDate` — original DOS filing date (`YYYY-MM-DD`)\n- `effectiveFilingDate` — effective date of the initial filing\n- `county`, `counties` — county (or counties, for a multi-county assumed name)\n- `jurisdiction` — state, province or country of formation\n- `assumedName`, `assumedNameId` — DBA name and its ID\n- `publicUrl` — a public company-registry page for the DOS ID (OpenCorporates)\n\n**Registration detail** *(with `includeDetails`)*\n\n- `sectionOfLaw` — section of law the entity is registered under\n- `statementStatus`, `nextStatementDueDate` — biennial-statement status and due date\n- `inactiveDate`, `reasonForStatus` — when and why the entity became inactive\n- `foreignFormationDate`, `foreignLegalName`, `fictitiousName`\n- `durationDate`, `latestDissolutionDate`, `nfpCategory`, `farmCorpFlag`\n- `serviceOfProcessName`, `serviceOfProcessAddress` — who receives legal process, with a structured address\n- `principalAddress`, `principalCity`, `principalState`, `principalZip`\n- `principalExecutiveAddress` — principal executive office, structured\n- `ceoName`, `ceoAddress` — chief executive officer on file\n- `registeredAgentName`, `registeredAgentAddress` — registered agent\n- `officerName`, `officerAddress` — chairman/CEO on file\n- `businessLocationName`, `businessLocationAddress`, `locationName`, `locationAddress`\n- `electronicServiceOfProcessStatus`, `electronicServiceOfProcessEmail`\n- `stockShares[]` — `{stockType, parValue, quantity}`\n\n**History** *(with `includeHistory`)*\n\n- `nameHistory[]` — `{entityName, documentType, fileDate, fileNumber}`\n- `filingHistory[]` — `{documentType, amendmentDescription, fileDate, fileNumber, pageCount}`\n- `mergerHistory[]` — `{documentType, survivorResultEntity, constituents, fileDate, fileNumber}`\n- `assumedNames[]` — `{assumedName, assumedNameId, status, fileDate}`\n\n**Metadata**\n\n- `sourceUrl` — the entity's record in the state's open-data feed (active entities)\n- `recordType: \"entity\"`, `scrapedAt`\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `byEntityName` | One of the 12 search modes |\n| `entityName` | string | `AMAZON` | Legal name (mode=byEntityName) |\n| `entityNameMatchType` | string | `startsWith` | `startsWith` / `contains` / `exact` |\n| `idNumbers` | array | – | DOS ID numbers; entity-page URLs accepted |\n| `assumedName` | string | – | DBA name (mode=byAssumedName) |\n| `assumedNameMatchType` | string | `contains` | `startsWith` / `contains` |\n| `assumedNameId` | string | – | Exact DBA ID (mode=byAssumedNameId) |\n| `agentName` | string | – | Registered agent (mode=byRegisteredAgent, active only) |\n| `agentMatchType` | string | `contains` | `startsWith` / `contains` |\n| `county` | string | `New York` | One of the 62 NY counties (mode=byCounty, active only) |\n| `entityType` | string | `DOMESTIC LIMITED LIABILITY COMPANY` | Exact entity type (mode=byEntityType, active only) |\n| `jurisdiction` | string | `Delaware` | Formation jurisdiction (mode=byJurisdiction, active only) |\n| `city` | string | `BROOKLYN` | Service-of-process city (mode=byCity, active only) |\n| `cityMatchType` | string | `startsWith` | `startsWith` / `contains` |\n| `officerName` | string | – | Officer/CEO (mode=byOfficerName, active only) |\n| `officerMatchType` | string | `contains` | `startsWith` / `contains` |\n| `zipCode` | string | `10001` | Service-of-process ZIP (mode=byZipCode, active only) |\n| `state` | string | `NY` | Service-of-process state code (mode=byState, active only) |\n| `entityStatus` | string | `Active` | `AllStatuses` / `Active` / `Inactive` / `Suspended` (official name and assumed-name modes) |\n| `entityTypeCategories` | array | all | Any of the four DOS categories |\n| `includeDetails` | boolean | `true` | Fetch the full registration detail |\n| `includeHistory` | boolean | `false` | Fetch name, filing, merger and assumed-name history |\n| `sortBy` | string | `source` | `source` / `newest` / `oldest` / `name` |\n| `searchTerms` | array | – | Extra names or DOS IDs searched in the same run |\n| `formationDateFrom` | string | – | `YYYY-MM-DD`, all modes |\n| `formationDateTo` | string | – | `YYYY-MM-DD`, all modes |\n| `maxItems` | int | `25` | Hard cap (1–5000) |\n\n### Example: inactive entities with full history\n\n```json\n{\n  \"mode\": \"byEntityName\",\n  \"entityName\": \"AMAZON\",\n  \"entityNameMatchType\": \"contains\",\n  \"entityStatus\": \"Inactive\",\n  \"includeDetails\": true,\n  \"includeHistory\": true,\n  \"maxItems\": 25\n}\n```\n\n### Example: find every business using a DBA\n\n```json\n{\n  \"mode\": \"byAssumedName\",\n  \"assumedName\": \"AMAZON FRESH\",\n  \"assumedNameMatchType\": \"contains\",\n  \"entityStatus\": \"AllStatuses\",\n  \"includeDetails\": true,\n  \"maxItems\": 25\n}\n```\n\n### Example: look up specific DOS IDs\n\n```json\n{\n  \"mode\": \"byIdentificationNumber\",\n  \"idNumbers\": [\"4809335\", \"4282851\", \"5561845\"],\n  \"includeDetails\": true,\n  \"includeHistory\": true\n}\n```\n\n### Example: browse active entities by county and date\n\n```json\n{\n  \"mode\": \"byCounty\",\n  \"county\": \"Kings\",\n  \"formationDateFrom\": \"2024-01-01\",\n  \"formationDateTo\": \"2024-12-31\",\n  \"sortBy\": \"newest\",\n  \"maxItems\": 100\n}\n```\n\n### Example: foreign entities formed in England\n\n```json\n{\n  \"mode\": \"byJurisdiction\",\n  \"jurisdiction\": \"ENGLAND\",\n  \"maxItems\": 50\n}\n```\n\n## Use cases\n\n- **Due diligence and KYC** — confirm legal name, DOS ID, formation date and current status before signing or onboarding a vendor\n- **Compliance and litigation research** — trace prior names, mergers and filing history for a New York entity\n- **Registered-agent research** — find the active entities a specific agent represents in New York\n- **DBA and brand research** — find the legal entity behind a storefront, brand or trade name\n- **Lead lists** — build active-business lists by county, ZIP code, entity type or formation date\n- **Name availability** — check existing names and DBAs before forming a new entity\n\n## FAQ\n\n**Where does the data come from?** The New York Department of State's public business-entity registry, plus its official open-data publication of active corporations. This is an independent tool and is not affiliated with the State of New York.\n\n**Is this data official or legally binding?** No. It is the same free informational data the Department of State publishes. For a certified Certificate of Status or certified copies, order them from the Department of State.\n\n**What do the statuses mean?** `Active` means the entity is current with the Department of State. `Inactive` means it was dissolved, terminated or otherwise ended, and `Suspended` means it is not in good standing. The `reasonForStatus` and `inactiveDate` fields explain an inactive record.\n\n**Why did my broad name search stop at 300 rows?** The state search returns at most 300 rows per query. The actor automatically splits broad searches by status, entity-type category and name prefix, but a very broad term can still be partial. Use a longer prefix or a narrower term.\n\n**Why are agent, CEO or business-location fields missing on some records?** Those fields are on file for only a minority of entities. The active-only open-data feed adds them for some active entities; inactive records usually only carry the official registration detail. Missing fields are omitted, never shown as blank.\n\n**Why does `exact` return fewer results than expected?** Exact mode filters the candidates returned by the state search. If the prefix itself is capped at 300 rows, the exact entity may not be among the returned candidates; use a full name with `startsWith` or reset the status filter.\n\n**How fresh is the data?** Status, detail and history come from the live registry. The supplementary agent/location feed is refreshed periodically by the state, so those fields can lag the live record.\n\n**Does history include filing documents?** No. History lists document type, date, file number, page count and amendment notes. Filing PDFs and images are ordered separately from the Department of State.\n\n**Do I need an API key or proxy?** No. The actor works out of the box with no account, key, cookie or proxy configuration.\n",
      "input": {
        "title": "New York Business Entity Search Input",
        "description": "Search New York Department of State business entities by name, DOS ID or assumed name, or browse the active registry by agent, county, type, jurisdiction, city, officer, ZIP or state. Active, inactive and suspended statuses are supported, with optional detail and filing history.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Search mode",
            "type": "string",
            "description": "What to search by. Fields labelled with a mode are only used by that mode.",
            "editor": "select",
            "enum": [
              "byEntityName",
              "byIdentificationNumber",
              "byAssumedName",
              "byAssumedNameId",
              "byRegisteredAgent",
              "byCounty",
              "byEntityType",
              "byJurisdiction",
              "byCity",
              "byOfficerName",
              "byZipCode",
              "byState"
            ],
            "enumTitles": [
              "By entity name",
              "By DOS ID number",
              "By assumed name (DBA)",
              "By assumed name ID",
              "By registered agent name",
              "By county",
              "By entity type",
              "By jurisdiction of formation",
              "By city",
              "By officer/CEO name",
              "By ZIP code",
              "By state"
            ],
            "default": "byEntityName",
            "prefill": "byEntityName"
          },
          "entityName": {
            "title": "Entity name (mode=byEntityName)",
            "type": "string",
            "description": "Legal business name to search for, e.g. `AMAZON` or `GOOGLE ACCESS`.",
            "editor": "textfield",
            "default": "AMAZON",
            "prefill": "AMAZON"
          },
          "entityNameMatchType": {
            "title": "Name match type (mode=byEntityName)",
            "type": "string",
            "description": "How the entity name is matched. `Exact match` is applied after the search returns.",
            "editor": "select",
            "enum": [
              "startsWith",
              "contains",
              "exact"
            ],
            "enumTitles": [
              "Begins with",
              "Contains",
              "Exact match"
            ],
            "default": "startsWith",
            "prefill": "startsWith"
          },
          "idNumbers": {
            "title": "DOS ID number(s) (mode=byIdentificationNumber)",
            "type": "array",
            "description": "Exact New York DOS ID numbers. Pasted entity-page URLs are accepted.",
            "editor": "stringList",
            "prefill": [
              "4087072"
            ]
          },
          "assumedName": {
            "title": "Assumed name / DBA (mode=byAssumedName)",
            "type": "string",
            "description": "Doing-business-as name to search for, e.g. `AMAZON FRESH`.",
            "editor": "textfield"
          },
          "assumedNameMatchType": {
            "title": "Assumed-name match type (mode=byAssumedName)",
            "type": "string",
            "description": "How the assumed name is matched.",
            "editor": "select",
            "enum": [
              "startsWith",
              "contains"
            ],
            "enumTitles": [
              "Begins with",
              "Contains"
            ],
            "default": "contains",
            "prefill": "contains"
          },
          "assumedNameId": {
            "title": "Assumed name ID (mode=byAssumedNameId)",
            "type": "string",
            "description": "Exact New York assumed-name (DBA) ID, e.g. `6502000`.",
            "editor": "textfield"
          },
          "agentName": {
            "title": "Registered agent name (mode=byRegisteredAgent)",
            "type": "string",
            "description": "Registered agent name to search for, e.g. `CT CORPORATION SYSTEM`. Active entities only.",
            "editor": "textfield"
          },
          "agentMatchType": {
            "title": "Agent match type (mode=byRegisteredAgent)",
            "type": "string",
            "description": "How the registered agent name is matched.",
            "editor": "select",
            "enum": [
              "startsWith",
              "contains"
            ],
            "enumTitles": [
              "Begins with",
              "Contains"
            ],
            "default": "contains",
            "prefill": "contains"
          },
          "county": {
            "title": "County (mode=byCounty)",
            "type": "string",
            "description": "New York county of the entity's service-of-process address. Active entities only.",
            "editor": "select",
            "enum": [
              "Albany",
              "Allegany",
              "Bronx",
              "Broome",
              "Cattaraugus",
              "Cayuga",
              "Chautauqua",
              "Chemung",
              "Chenango",
              "Clinton",
              "Columbia",
              "Cortland",
              "Delaware",
              "Dutchess",
              "Erie",
              "Essex",
              "Franklin",
              "Fulton",
              "Genesee",
              "Greene",
              "Hamilton",
              "Herkimer",
              "Jefferson",
              "Kings",
              "Lewis",
              "Livingston",
              "Madison",
              "Monroe",
              "Montgomery",
              "Nassau",
              "New York",
              "Niagara",
              "Oneida",
              "Onondaga",
              "Ontario",
              "Orange",
              "Orleans",
              "Oswego",
              "Otsego",
              "Putnam",
              "Queens",
              "Rensselaer",
              "Richmond",
              "Rockland",
              "Saratoga",
              "Schenectady",
              "Schoharie",
              "Schuyler",
              "Seneca",
              "St. Lawrence",
              "Steuben",
              "Suffolk",
              "Sullivan",
              "Tioga",
              "Tompkins",
              "Ulster",
              "Unknown",
              "Warren",
              "Washington",
              "Wayne",
              "Westchester",
              "Wyoming",
              "Yates"
            ],
            "enumTitles": [
              "Albany",
              "Allegany",
              "Bronx",
              "Broome",
              "Cattaraugus",
              "Cayuga",
              "Chautauqua",
              "Chemung",
              "Chenango",
              "Clinton",
              "Columbia",
              "Cortland",
              "Delaware",
              "Dutchess",
              "Erie",
              "Essex",
              "Franklin",
              "Fulton",
              "Genesee",
              "Greene",
              "Hamilton",
              "Herkimer",
              "Jefferson",
              "Kings (Brooklyn)",
              "Lewis",
              "Livingston",
              "Madison",
              "Monroe",
              "Montgomery",
              "Nassau",
              "New York (Manhattan)",
              "Niagara",
              "Oneida",
              "Onondaga",
              "Ontario",
              "Orange",
              "Orleans",
              "Oswego",
              "Otsego",
              "Putnam",
              "Queens",
              "Rensselaer",
              "Richmond (Staten Island)",
              "Rockland",
              "Saratoga",
              "Schenectady",
              "Schoharie",
              "Schuyler",
              "Seneca",
              "St. Lawrence",
              "Steuben",
              "Suffolk",
              "Sullivan",
              "Tioga",
              "Tompkins",
              "Ulster",
              "Unknown / not recorded",
              "Warren",
              "Washington",
              "Wayne",
              "Westchester",
              "Wyoming",
              "Yates"
            ],
            "default": "New York",
            "prefill": "New York"
          },
          "entityType": {
            "title": "Entity type (mode=byEntityType)",
            "type": "string",
            "description": "Exact entity type recorded by NY DOS. Active entities only. For the broader official categories use `entityTypeCategories`.",
            "editor": "select",
            "enum": [
              "DOMESTIC BENEFIT CORPORATION",
              "DOMESTIC BENEVOLENT ORDER",
              "DOMESTIC BUSINESS CORPORATION",
              "DOMESTIC CONDOMINIUM",
              "DOMESTIC CONDOMINIUM DECLARATION",
              "DOMESTIC COOPERATIVE CORPORATION",
              "DOMESTIC COOPERATIVE CORPORATION (WORKER COOPERATIVE)",
              "DOMESTIC DESIGN PROFESSIONAL SERVICE CORPORATION",
              "DOMESTIC GENERAL ASSOCIATION",
              "DOMESTIC GOVERNMENTAL AGENCY",
              "DOMESTIC HOUSING DEVELOPMENT FUND COMPANY (ARTICLE XI)",
              "DOMESTIC JOINT STOCK ASSOCIATION",
              "DOMESTIC LIMITED LIABILITY COMPANY",
              "DOMESTIC LIMITED PARTNERSHIP",
              "DOMESTIC LIMITED-PROFIT HOUSING COMPANY (ARTICLE 2 PHFL & BCL)",
              "DOMESTIC LIMITED-PROFIT HOUSING COMPANY (ARTICLE 2 PHFL & NPCL)",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (BOARD OF TRADE AND CHAMBER OF COMMERCE CORPORATION)",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (COMMUNITY MENTAL HEALTH SERVICES AND MENTAL RETARDATION SERVICES COMPANIES)",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (FIRE CORPORATION)",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (HOUSING DEVELOPMENT FUND COMPANY) (ARTICLE XI)",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (LAND BANK)",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (LOCAL DEVELOPMENT CORPORATION)",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (MILITIA ASSOCIATION)",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (PUBLIC CEMETERY CORPORATION)",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (UNIVERSITY FACULTY PRACTICE CORPORATION)",
              "DOMESTIC PROFESSIONAL SERVICE CORPORATION",
              "DOMESTIC PROFESSIONAL SERVICE LIMITED LIABILITY COMPANY",
              "DOMESTIC PUBLIC BENEFIT CORPORATION",
              "DOMESTIC RAILROAD CORPORATION",
              "DOMESTIC REDEVELOPMENT COMPANY (ARTICLE V)",
              "DOMESTIC REDEVELOPMENT COMPANY (LIMITED LIABILITY COMPANY)",
              "DOMESTIC REDEVELOPMENT COMPANY (LIMITED PARTNERSHIP)",
              "DOMESTIC REGISTERED LIMITED LIABILITY PARTNERSHIP",
              "DOMESTIC RELIGIOUS CORPORATION",
              "DOMESTIC RELIGIOUS CORPORATION (GOVERNING OR ADVISORY BODY)",
              "DOMESTIC TRANSPORTATION CORPORATION",
              "FOREIGN BUSINESS CORPORATION",
              "FOREIGN COOPERATIVE CORPORATION",
              "FOREIGN DESIGNATION OF THE SECRETARY OF STATE",
              "FOREIGN GENERAL ASSOCIATION",
              "FOREIGN LIMITED LIABILITY COMPANY",
              "FOREIGN LIMITED PARTNERSHIP",
              "FOREIGN NOT-FOR-PROFIT CORPORATION",
              "FOREIGN PROFESSIONAL SERVICE CORPORATION",
              "FOREIGN PROFESSIONAL SERVICE LIMITED LIABILITY COMPANY",
              "FOREIGN RELIGIOUS CORPORATION",
              "GENERAL ASSOCIATION DESIGNATION",
              "NEW YORK REGISTERED FOREIGN LIMITED LIABILITY PARTNERSHIP",
              "RESERVATION OF DOMESTIC LIMITED LIABILITY COMPANY",
              "UNAUTHORIZED BUSINESS CORPORATION",
              "UNAUTHORIZED FOREIGN BUSINESS CORPORATION",
              "UNAUTHORIZED FOREIGN LIMITED LIABILITY COMPANY"
            ],
            "enumTitles": [
              "Domestic Benefit Corporation",
              "Domestic Benevolent Order",
              "Domestic Business Corporation",
              "Domestic Condominium",
              "Domestic Condominium Declaration",
              "Domestic Cooperative Corporation",
              "Domestic Cooperative Corporation (Worker Cooperative)",
              "Domestic Design Professional Service Corporation",
              "Domestic General Association",
              "Domestic Governmental Agency",
              "Domestic Housing Development Fund Company (Article XI)",
              "Domestic Joint Stock Association",
              "Domestic Limited Liability Company",
              "Domestic Limited Partnership",
              "Domestic Limited-Profit Housing Company (Article 2 PHFL & BCL)",
              "Domestic Limited-Profit Housing Company (Article 2 PHFL & NPCL)",
              "Domestic Not-for-Profit Corporation",
              "Domestic Not-for-Profit Corp. (Board of Trade and Chamber of Commerce)",
              "Domestic Not-for-Profit Corp. (Community Mental Health Services)",
              "Domestic Not-for-Profit Corp. (Fire Corporation)",
              "Domestic Not-for-Profit Corp. (Housing Dev. Fund Co., Article XI)",
              "Domestic Not-for-Profit Corp. (Land Bank)",
              "Domestic Not-for-Profit Corp. (Local Development Corporation)",
              "Domestic Not-for-Profit Corp. (Militia Association)",
              "Domestic Not-for-Profit Corp. (Public Cemetery Corporation)",
              "Domestic Not-for-Profit Corp. (University Faculty Practice)",
              "Domestic Professional Service Corporation",
              "Domestic Professional Service Limited Liability Company",
              "Domestic Public Benefit Corporation",
              "Domestic Railroad Corporation",
              "Domestic Redevelopment Company (Article V)",
              "Domestic Redevelopment Company (Limited Liability Company)",
              "Domestic Redevelopment Company (Limited Partnership)",
              "Domestic Registered Limited Liability Partnership",
              "Domestic Religious Corporation",
              "Domestic Religious Corporation (Governing or Advisory Body)",
              "Domestic Transportation Corporation",
              "Foreign Business Corporation",
              "Foreign Cooperative Corporation",
              "Foreign Designation of the Secretary of State",
              "Foreign General Association",
              "Foreign Limited Liability Company",
              "Foreign Limited Partnership",
              "Foreign Not-for-Profit Corporation",
              "Foreign Professional Service Corporation",
              "Foreign Professional Service Limited Liability Company",
              "Foreign Religious Corporation",
              "General Association Designation",
              "New York Registered Foreign Limited Liability Partnership",
              "Reservation of Domestic Limited Liability Company",
              "Unauthorized Business Corporation",
              "Unauthorized Foreign Business Corporation",
              "Unauthorized Foreign Limited Liability Company"
            ],
            "default": "DOMESTIC LIMITED LIABILITY COMPANY",
            "prefill": "DOMESTIC LIMITED LIABILITY COMPANY"
          },
          "jurisdiction": {
            "title": "Jurisdiction of formation (mode=byJurisdiction)",
            "type": "string",
            "description": "State, territory, province or country where the entity was originally formed. Active entities only.",
            "editor": "select",
            "enum": [
              "Alabama",
              "Alaska",
              "Alberta",
              "American Samoa",
              "Arizona",
              "Arkansas",
              "Armed Forces (Africa, Canada, Europe, Middle East)",
              "Armed Forces Pacific",
              "British Columbia",
              "CANAL ZONE",
              "CAROLINE ISLANDS",
              "California",
              "Colorado",
              "Connecticut",
              "Delaware",
              "District of Columbia",
              "ENGLAND",
              "ENGLAND-WALES",
              "FEDERATED STATES OF MICRONESIA",
              "Florida",
              "Georgia",
              "Guam",
              "Hawaii",
              "Idaho",
              "Illinois",
              "Indiana",
              "Iowa",
              "Kansas",
              "Kentucky",
              "Louisiana",
              "MARSHALL ISLANDS",
              "Maine",
              "Manitoba",
              "Maryland",
              "Massachusetts",
              "Michigan",
              "Minnesota",
              "Mississippi",
              "Missouri",
              "Montana",
              "NEWFOUNDLAND",
              "NORTHERN IRELAND",
              "NORTHWEST TERRITORIES",
              "NUNAVUT",
              "Nebraska",
              "Nevada",
              "New Brunswick",
              "New Hampshire",
              "New Jersey",
              "New Mexico",
              "New York",
              "North Carolina",
              "North Dakota",
              "Nova Scotia",
              "Ohio",
              "Oklahoma",
              "Ontario",
              "Oregon",
              "PALAU",
              "PRINCE EDWARD ISLAND",
              "Pennsylvania",
              "Puerto Rico",
              "QUEBEC",
              "Rhode Island",
              "SASKATCHEWAN",
              "SCOTLAND",
              "South Carolina",
              "South Dakota",
              "Tennessee",
              "Texas",
              "U.S. Minor Outlying Islands",
              "U.S. Virgin Islands",
              "Utah",
              "Vermont",
              "Virginia",
              "WAKE ISLAND",
              "WALES",
              "Washington",
              "West Virginia",
              "Wisconsin",
              "Wyoming"
            ],
            "enumTitles": [
              "Alabama",
              "Alaska",
              "Alberta",
              "American Samoa",
              "Arizona",
              "Arkansas",
              "Armed Forces (Africa, Canada, Europe, Middle East)",
              "Armed Forces Pacific",
              "British Columbia",
              "Canal Zone",
              "Caroline Islands",
              "California",
              "Colorado",
              "Connecticut",
              "Delaware",
              "District of Columbia",
              "England",
              "England and Wales",
              "Federated States of Micronesia",
              "Florida",
              "Georgia",
              "Guam",
              "Hawaii",
              "Idaho",
              "Illinois",
              "Indiana",
              "Iowa",
              "Kansas",
              "Kentucky",
              "Louisiana",
              "Marshall Islands",
              "Maine",
              "Manitoba",
              "Maryland",
              "Massachusetts",
              "Michigan",
              "Minnesota",
              "Mississippi",
              "Missouri",
              "Montana",
              "Newfoundland",
              "Northern Ireland",
              "Northwest Territories",
              "Nunavut",
              "Nebraska",
              "Nevada",
              "New Brunswick",
              "New Hampshire",
              "New Jersey",
              "New Mexico",
              "New York",
              "North Carolina",
              "North Dakota",
              "Nova Scotia",
              "Ohio",
              "Oklahoma",
              "Ontario",
              "Oregon",
              "Palau",
              "Prince Edward Island",
              "Pennsylvania",
              "Puerto Rico",
              "Quebec",
              "Rhode Island",
              "Saskatchewan",
              "Scotland",
              "South Carolina",
              "South Dakota",
              "Tennessee",
              "Texas",
              "U.S. Minor Outlying Islands",
              "U.S. Virgin Islands",
              "Utah",
              "Vermont",
              "Virginia",
              "Wake Island",
              "Wales",
              "Washington",
              "West Virginia",
              "Wisconsin",
              "Wyoming"
            ],
            "default": "Delaware",
            "prefill": "Delaware"
          },
          "city": {
            "title": "City (mode=byCity)",
            "type": "string",
            "description": "City of the service-of-process address, e.g. `BROOKLYN`. Active entities only.",
            "editor": "textfield",
            "default": "BROOKLYN",
            "prefill": "BROOKLYN"
          },
          "cityMatchType": {
            "title": "City match type (mode=byCity)",
            "type": "string",
            "description": "How the city is matched.",
            "editor": "select",
            "enum": [
              "startsWith",
              "contains"
            ],
            "enumTitles": [
              "Begins with",
              "Contains"
            ],
            "default": "startsWith",
            "prefill": "startsWith"
          },
          "officerName": {
            "title": "Officer/CEO name (mode=byOfficerName)",
            "type": "string",
            "description": "Officer, chairman or CEO name on file. Active entities only. Populated for a minority of entities.",
            "editor": "textfield"
          },
          "officerMatchType": {
            "title": "Officer match type (mode=byOfficerName)",
            "type": "string",
            "description": "How the officer name is matched.",
            "editor": "select",
            "enum": [
              "startsWith",
              "contains"
            ],
            "enumTitles": [
              "Begins with",
              "Contains"
            ],
            "default": "contains",
            "prefill": "contains"
          },
          "zipCode": {
            "title": "ZIP code (mode=byZipCode)",
            "type": "string",
            "description": "5-digit ZIP of the service-of-process address, e.g. `10001`. ZIP+4 is accepted and truncated. Active entities only.",
            "editor": "textfield",
            "default": "10001",
            "prefill": "10001"
          },
          "state": {
            "title": "State (mode=byState)",
            "type": "string",
            "description": "2-letter state/territory code of the service-of-process address (not the formation jurisdiction). Active entities only.",
            "editor": "select",
            "enum": [
              "AL",
              "AK",
              "AZ",
              "AR",
              "CA",
              "CO",
              "CT",
              "DE",
              "DC",
              "FL",
              "GA",
              "HI",
              "ID",
              "IL",
              "IN",
              "IA",
              "KS",
              "KY",
              "LA",
              "ME",
              "MD",
              "MA",
              "MI",
              "MN",
              "MS",
              "MO",
              "MT",
              "NE",
              "NV",
              "NH",
              "NJ",
              "NM",
              "NY",
              "NC",
              "ND",
              "OH",
              "OK",
              "OR",
              "PA",
              "RI",
              "SC",
              "SD",
              "TN",
              "TX",
              "UT",
              "VT",
              "VA",
              "WA",
              "WV",
              "WI",
              "WY",
              "AS",
              "GU",
              "MP",
              "PR",
              "VI",
              "AE",
              "AA",
              "AP",
              "MH",
              "PW",
              "CZ",
              "MW",
              "NA",
              "WK"
            ],
            "enumTitles": [
              "Alabama",
              "Alaska",
              "Arizona",
              "Arkansas",
              "California",
              "Colorado",
              "Connecticut",
              "Delaware",
              "District of Columbia",
              "Florida",
              "Georgia",
              "Hawaii",
              "Idaho",
              "Illinois",
              "Indiana",
              "Iowa",
              "Kansas",
              "Kentucky",
              "Louisiana",
              "Maine",
              "Maryland",
              "Massachusetts",
              "Michigan",
              "Minnesota",
              "Mississippi",
              "Missouri",
              "Montana",
              "Nebraska",
              "Nevada",
              "New Hampshire",
              "New Jersey",
              "New Mexico",
              "New York",
              "North Carolina",
              "North Dakota",
              "Ohio",
              "Oklahoma",
              "Oregon",
              "Pennsylvania",
              "Rhode Island",
              "South Carolina",
              "South Dakota",
              "Tennessee",
              "Texas",
              "Utah",
              "Vermont",
              "Virginia",
              "Washington",
              "West Virginia",
              "Wisconsin",
              "Wyoming",
              "American Samoa",
              "Guam",
              "Northern Mariana Islands",
              "Puerto Rico",
              "U.S. Virgin Islands",
              "Armed Forces Europe/Canada/Middle East (AE)",
              "Armed Forces Americas (AA)",
              "Armed Forces Pacific (AP)",
              "Marshall Islands",
              "Palau",
              "Canal Zone",
              "MW (midway / other)",
              "NA (not assigned)",
              "WK (Wake Island)"
            ],
            "default": "NY",
            "prefill": "NY"
          },
          "entityStatus": {
            "title": "Entity status (official modes)",
            "type": "string",
            "description": "Filter by live DOS status: active, inactive or suspended. Applies to name, assumed-name and assumed-name ID searches. DOS-ID lookups always return the entity's real status. Legacy active-only browse modes ignore it.",
            "editor": "select",
            "enum": [
              "AllStatuses",
              "Active",
              "Inactive",
              "Suspended"
            ],
            "enumTitles": [
              "All statuses",
              "Active",
              "Inactive",
              "Suspended"
            ],
            "default": "Active",
            "prefill": "Active"
          },
          "entityTypeCategories": {
            "title": "Entity type categories (official modes)",
            "type": "array",
            "description": "Limit official name/assumed-name searches to one or more of the four DOS categories. Leave empty for all.",
            "editor": "select",
            "items": {
              "type": "string",
              "enum": [
                "Corporation",
                "LimitedLiabilityCompany",
                "LimitedPartnership",
                "LimitedLiabilityPartnership"
              ],
              "enumTitles": [
                "Corporation",
                "Limited liability company",
                "Limited partnership",
                "Limited liability partnership"
              ]
            },
            "prefill": [],
            "uniqueItems": true,
            "default": []
          },
          "includeDetails": {
            "title": "Include full entity detail",
            "type": "boolean",
            "description": "Fetch each entity's detail record (section of law, CEO, stock, statement status, addresses, e-service). Adds one request per record.",
            "default": true,
            "prefill": false
          },
          "includeHistory": {
            "title": "Include filing and name history",
            "type": "boolean",
            "description": "Fetch name, filing, merger and assumed-name history for each record. Adds up to four requests per record.",
            "default": false,
            "prefill": false
          },
          "sortBy": {
            "title": "Sort results",
            "type": "string",
            "description": "Order of the emitted records. `Source order` keeps the order returned by the registry.",
            "editor": "select",
            "enum": [
              "source",
              "newest",
              "oldest",
              "name"
            ],
            "enumTitles": [
              "Source order",
              "Newest first",
              "Oldest first",
              "Name A-Z"
            ],
            "default": "source",
            "prefill": "source"
          },
          "searchTerms": {
            "title": "Additional search terms",
            "type": "array",
            "description": "Extra names or DOS IDs searched in the same run and merged with the main term. Applies to name, assumed-name and DOS-ID modes.",
            "editor": "stringList"
          },
          "formationDateFrom": {
            "title": "Formation date from (all modes)",
            "type": "string",
            "description": "Only include entities formed/registered on or after this date (`YYYY-MM-DD`).",
            "editor": "textfield"
          },
          "formationDateTo": {
            "title": "Formation date to (all modes)",
            "type": "string",
            "description": "Only include entities formed/registered on or before this date (`YYYY-MM-DD`).",
            "editor": "textfield"
          },
          "maxItems": {
            "title": "Max items",
            "type": "integer",
            "description": "Hard cap on emitted records (1-5000).",
            "minimum": 1,
            "maximum": 5000,
            "default": 25,
            "prefill": 1
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "New York Business Entity Search & Filing History Output",
        "description": "New York business entities with live status, identity, agents, addresses, stock and optional name, filing, merger and assumed-name history.",
        "properties": {
          "entities": {
            "type": "string",
            "title": "New York entities",
            "description": "Dataset containing all scraped New York business entity records.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Entities",
              "transformation": {
                "fields": [
                  "entityName",
                  "idNumber",
                  "entityType",
                  "status",
                  "formationDate",
                  "county",
                  "assumedName"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {},
      "defaultMemoryMbytes": 1024
    },
    "buildNumber": "1.1.1",
    "imageDigest": "fc98066a555a7c48abc619338a6f411966cdfad38d28573df59ef222ab8c129d",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.1"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.005841111111111111
    }
  }
}