# New York Secretary of State Business Entity Search Scraper (`crawlerbros/new-york-sos-business-search-scraper`) Actor Search New York's free public business entity database by entity name, ID number, registered agent, county, entity type, jurisdiction, city, or officer name. Get entity type, formation date, registered agent, and business address details. - **URL**: https://apify.com/crawlerbros/new-york-sos-business-search-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Automation, Lead generation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## New York Secretary of State Business Entity Search Scraper Search the **New York Department of State's** free public business entity registry. Look up a business by entity name, DOS ID number, registered agent, county, entity type, jurisdiction (state/country of formation), city, ZIP code, or officer/CEO name — and get entity type, formation date, county, jurisdiction, registered agent, service-of-process address, officer, and business location details. HTTP-only via the Department of State's official open-data API — no login, no CAPTCHA, no proxy required. ### Data Source & Usage Notes **Read this before running a large job.** - **Source: `data.ny.gov`, the New York Department of State's official open-data portal**, dataset "Active Corporations: Beginning 1800" (resource ID `n9v6-gdp6`). This is the Department of State's own machine-readable mirror of the same live business-entity registry that powers its public search page. - **Why the open-data API instead of the live search page?** The Department of State's own HTML search application (`dos.ny.gov/corps/bus_entity_search.html`, which redirects to `apps.dos.ny.gov/publicInquiry/`) resets the connection for non-browser/datacenter traffic on every request — confirmed live from two independent network paths. Its open-data API has no such restriction: it is a plain public JSON REST endpoint, refreshed regularly, with no login and no CAPTCHA. - **Every record is a currently Active entity.** The underlying dataset is scoped to active entities only, so `status` is always `"Active"` on every record. New York does not publish a free open-data feed of dissolved/inactive entities. - **No proxy needed.** This is a plain public JSON API — no anti-bot measures were observed and none of Apify's proxy groups are used. #### Why New York instead of Missouri? This actor was originally scoped as a Missouri Secretary of State business entity search (`bsd.sos.mo.gov` / `www.sos.mo.gov/BusinessEntity`). Live verification showed the entire `sos.mo.gov` domain — including the bare homepage, not just the search subpages — returns a flat Cloudflare `403 Forbidden` on every request, from `curl` with a real browser User-Agent and from an independent fetch tool on a separate network path alike. This is a domain-wide block on non-browser/datacenter traffic, not a per-page anomaly, and it would equally block Apify's free `AUTO` proxy group. Per this project's zero-cost reliability policy, the target was replaced with New York's Secretary of State business entity registry — published as a free, no-login, no-CAPTCHA open-data API by the NY Department of State, confirmed live and returning real data. ### What this actor does - **10 search modes**, covering every reliable, no-auth axis the source's open-data API supports: - `byEntityName` — entity name, with begins-with / contains / exact match - `byIdentificationNumber` — one or more exact DOS ID numbers - `byRegisteredAgent` — registered agent name, with begins-with / contains match - `byCounty` — browse by New York county (service-of-process address) - `byEntityType` — browse by entity type (LLC, corporation, not-for-profit, etc.) - `byJurisdiction` — browse by state/country of formation (domestic NY vs. foreign entities) - `byCity` — city of the service-of-process address, with begins-with / contains match - `byOfficerName` — officer/chairman/CEO name on file, with begins-with / contains match - `byZipCode` — exact 5-digit ZIP code of the service-of-process address (populated on ~98% of records) - `byState` — browse by US state/territory (2-letter code) of the service-of-process address (not the jurisdiction of formation) - **Optional formation-date range filter** (`formationDateFrom` / `formationDateTo`) on every mode - **Full entity detail** on every record — type, formation date, county, jurisdiction, registered agent, service-of-process address, officer (when on file), and business location (when on file) - **Empty fields are omitted** ### What's NOT included (and why) - **Inactive/dissolved entities** — the source dataset is scoped to currently Active entities only; New York does not publish a free open-data feed of historical/dissolved filings. - **Filing history / document images** — the open-data API exposes current entity-level data only, not a timeline of individual filed documents; certified copies and filing history require the Department of State's paid ordering channels. - **Officer/CEO name** (`officerName`) — only present for a minority of entities (mostly not-for-profits and older filings); most active LLCs and business corporations don't have this field on file, and it is omitted when absent rather than left null. - **Business location** (`businessLocationName`/`businessLocationAddress`) — only present on file for a subset of entities (roughly 8%); omitted when absent. ### Output per entity - `entityName` - `idNumber` — New York DOS ID number - `entityType` — e.g. `DOMESTIC LIMITED LIABILITY COMPANY`, `DOMESTIC BUSINESS CORPORATION` - `status` — always `Active` (see Data Source notes) - `formationDate` — `YYYY-MM-DD` - `county` — county of the service-of-process address - `jurisdiction` — state/country of formation - `principalAddress`, `principalCity`, `principalState`, `principalZip` — service-of-process (DOS process) address - `serviceOfProcessName` — name DOS mails legal process to - `registeredAgentName`, `registeredAgentAddress` — when on file - `officerName`, `officerAddress` — chairman/CEO on file, when present - `businessLocationName`, `businessLocationAddress` — when on file - `sourceUrl` — direct link to the entity's record on the official open-data API - `recordType: "entity"`, `scrapedAt` ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | string | `byEntityName` | One of the 10 search modes | | `entityName` | string | `AMAZON` | mode=byEntityName | | `entityNameMatchType` | string | `startsWith` | `startsWith`/`contains`/`exact` | | `idNumbers` | array | `["4087072"]` | mode=byIdentificationNumber — one or more DOS ID numbers | | `agentName` | string | – | mode=byRegisteredAgent | | `agentMatchType` | string | `contains` | `startsWith`/`contains` | | `county` | string | `New York` | mode=byCounty — one of the 62 NY counties | | `entityType` | string | `DOMESTIC LIMITED LIABILITY COMPANY` | mode=byEntityType | | `jurisdiction` | string | `Delaware` | mode=byJurisdiction | | `city` | string | `BROOKLYN` | mode=byCity | | `cityMatchType` | string | `startsWith` | `startsWith`/`contains` | | `officerName` | string | – | mode=byOfficerName | | `officerMatchType` | string | `contains` | `startsWith`/`contains` | | `zipCode` | string | `10001` | mode=byZipCode — 5-digit US ZIP (ZIP+4 accepted, truncated) | | `state` | string | `NY` | mode=byState — 2-letter US state/territory postal code of service-of-process address | | `formationDateFrom` | string | – | Optional, `YYYY-MM-DD`, all modes | | `formationDateTo` | string | – | Optional, `YYYY-MM-DD`, all modes | | `maxItems` | int | `25` | Hard cap (1–5000) | #### Example: search by entity name prefix ```json { "mode": "byEntityName", "entityName": "TESLA", "entityNameMatchType": "startsWith", "maxItems": 10 } ```` #### Example: lookup by exact DOS ID number(s) ```json { "mode": "byIdentificationNumber", "idNumbers": ["4087072", "4335119"] } ``` #### Example: browse by county + entity type + date range ```json { "mode": "byCounty", "county": "Kings", "formationDateFrom": "2024-01-01", "formationDateTo": "2024-01-31", "maxItems": 50 } ``` #### Example: search by registered agent ```json { "mode": "byRegisteredAgent", "agentName": "CORPORATION SERVICE COMPANY", "agentMatchType": "contains", "maxItems": 25 } ``` #### Example: browse foreign entities by jurisdiction ```json { "mode": "byJurisdiction", "jurisdiction": "Delaware", "entityType": "FOREIGN LIMITED LIABILITY COMPANY", "maxItems": 25 } ``` #### Example: browse by ZIP code ```json { "mode": "byZipCode", "zipCode": "10001", "maxItems": 25 } ``` #### Example: browse by service-of-process state ```json { "mode": "byState", "state": "CA", "maxItems": 25 } ``` ### Use cases - **Due diligence** — confirm a counterparty's New York formation date, entity type, and registered agent before contracting - **Compliance & KYC** — cross-check a business's legal entity name and DOS ID number - **Registered agent research** — find every entity a specific agent represents in New York - **Market research** — pull every active entity of a given type/county/jurisdiction/ZIP code - **Local prospecting** — build a lead list of every active business registered at a specific ZIP code - **Company name availability checks** — see what similarly-named entities already exist before choosing a new name - **Out-of-state incorporation research** — find every entity formed under a specific jurisdiction (e.g. Delaware) doing business in New York ### FAQ **What's the data source?** The New York Department of State's official open-data portal (`data.ny.gov`), dataset "Active Corporations: Beginning 1800". This actor is an independent third-party tool and is not affiliated with the State of New York. **Is this data official / legally binding?** No. For a certified Certificate of Status or certified copies, use the Department of State's paid ordering channels. This actor returns the same free-tier informational data the Department of State publishes as open data. **Why does every record show `status: Active`?** The underlying open-data feed only covers currently active entities — New York does not publish a free feed of inactive/dissolved entities. **Why did my run return 0 results?** Either the query genuinely has no match, or the match type (begins-with vs. contains vs. exact) is narrower than expected. Try a broader match type or a shorter search term. **What's the difference between the match types?** `Begins with` matches the start of the field; `Contains` matches anywhere within it; `Exact match` (entity name only) requires the full name. **How fresh is the data?** The Department of State refreshes this open-data feed on an ongoing basis (typically daily/weekly); it is not instantaneous but is not a stale annual snapshot either. **Why is `officerName` empty for most results?** New York only requires officer/chairman information on file for a subset of entity types (mostly not-for-profits and some older filings); it is genuinely absent for most LLCs and business corporations, so it's omitted rather than shown as blank. # Actor input Schema ## `mode` (type: `string`): Which search axis to use. ## `entityName` (type: `string`): Business entity name to search for, e.g. `AMAZON`. ## `entityNameMatchType` (type: `string`): How `entityName` is matched. ## `idNumbers` (type: `array`): One or more exact New York DOS ID numbers, e.g. `4087072`. ## `agentName` (type: `string`): Registered agent name to search for, e.g. `CT CORPORATION SYSTEM`. ## `agentMatchType` (type: `string`): How `agentName` is matched. ## `county` (type: `string`): New York county where the entity's service-of-process address is located. ## `entityType` (type: `string`): Type of business entity, as recorded by NY DOS. ## `jurisdiction` (type: `string`): State, US territory, Canadian province, or country where the entity was originally formed (New York = domestic; anything else = foreign). ## `city` (type: `string`): City of the entity's service-of-process address, e.g. `BROOKLYN`. ## `cityMatchType` (type: `string`): How `city` is matched. ## `officerName` (type: `string`): Officer/chairman/CEO name on file to search for. Only populated for a subset of entities (mostly not-for-profits and older filings). ## `officerMatchType` (type: `string`): How `officerName` is matched. ## `zipCode` (type: `string`): 5-digit US ZIP code of the entity's service-of-process address, e.g. `10001`. ZIP+4 is accepted and truncated to 5 digits. ## `state` (type: `string`): US state/territory (2-letter postal code) of the entity's service-of-process address. Note this is the mailing-address state, not the jurisdiction of formation -- use `byJurisdiction` for that. ## `formationDateFrom` (type: `string`): Optional: only include entities formed/registered on or after this date, format `YYYY-MM-DD`. ## `formationDateTo` (type: `string`): Optional: only include entities formed/registered on or before this date, format `YYYY-MM-DD`. ## `maxItems` (type: `integer`): Hard cap on emitted records. ## Actor input object example ```json { "mode": "byEntityName", "entityName": "AMAZON", "entityNameMatchType": "startsWith", "idNumbers": [ "4087072" ], "agentMatchType": "contains", "county": "New York", "entityType": "DOMESTIC LIMITED LIABILITY COMPANY", "jurisdiction": "Delaware", "city": "BROOKLYN", "cityMatchType": "startsWith", "officerMatchType": "contains", "zipCode": "10001", "state": "NY", "maxItems": 10 } ``` # Actor output Schema ## `entities` (type: `string`): Dataset containing all scraped New York business entity records. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "byEntityName", "entityName": "AMAZON", "entityNameMatchType": "startsWith", "idNumbers": [ "4087072" ], "agentMatchType": "contains", "county": "New York", "entityType": "DOMESTIC LIMITED LIABILITY COMPANY", "jurisdiction": "Delaware", "city": "BROOKLYN", "cityMatchType": "startsWith", "officerMatchType": "contains", "zipCode": "10001", "state": "NY", "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/new-york-sos-business-search-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "byEntityName", "entityName": "AMAZON", "entityNameMatchType": "startsWith", "idNumbers": ["4087072"], "agentMatchType": "contains", "county": "New York", "entityType": "DOMESTIC LIMITED LIABILITY COMPANY", "jurisdiction": "Delaware", "city": "BROOKLYN", "cityMatchType": "startsWith", "officerMatchType": "contains", "zipCode": "10001", "state": "NY", "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/new-york-sos-business-search-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "mode": "byEntityName", "entityName": "AMAZON", "entityNameMatchType": "startsWith", "idNumbers": [ "4087072" ], "agentMatchType": "contains", "county": "New York", "entityType": "DOMESTIC LIMITED LIABILITY COMPANY", "jurisdiction": "Delaware", "city": "BROOKLYN", "cityMatchType": "startsWith", "officerMatchType": "contains", "zipCode": "10001", "state": "NY", "maxItems": 10 }' | apify call crawlerbros/new-york-sos-business-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/new-york-sos-business-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "New York Secretary of State Business Entity Search Scraper", "description": "Search New York's free public business entity database by entity name, ID number, registered agent, county, entity type, jurisdiction, city, or officer name. Get entity type, formation date, registered agent, and business address details.", "version": "1.0", "x-build-id": "zz14RSWgMafU5qUBq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~new-york-sos-business-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-new-york-sos-business-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/crawlerbros~new-york-sos-business-search-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-new-york-sos-business-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/crawlerbros~new-york-sos-business-search-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-new-york-sos-business-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Search mode", "enum": [ "byEntityName", "byIdentificationNumber", "byRegisteredAgent", "byCounty", "byEntityType", "byJurisdiction", "byCity", "byOfficerName", "byZipCode", "byState" ], "type": "string", "description": "Which search axis to use.", "default": "byEntityName" }, "entityName": { "title": "Entity name (mode=byEntityName)", "type": "string", "description": "Business entity name to search for, e.g. `AMAZON`.", "default": "AMAZON" }, "entityNameMatchType": { "title": "Entity name match type (mode=byEntityName)", "enum": [ "startsWith", "contains", "exact" ], "type": "string", "description": "How `entityName` is matched.", "default": "startsWith" }, "idNumbers": { "title": "DOS ID number(s) (mode=byIdentificationNumber)", "type": "array", "description": "One or more exact New York DOS ID numbers, e.g. `4087072`.", "items": { "type": "string" } }, "agentName": { "title": "Registered agent name (mode=byRegisteredAgent)", "type": "string", "description": "Registered agent name to search for, e.g. `CT CORPORATION SYSTEM`." }, "agentMatchType": { "title": "Agent name match type (mode=byRegisteredAgent)", "enum": [ "startsWith", "contains" ], "type": "string", "description": "How `agentName` is matched.", "default": "contains" }, "county": { "title": "County (mode=byCounty)", "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", "Warren", "Washington", "Wayne", "Westchester", "Wyoming", "Yates" ], "type": "string", "description": "New York county where the entity's service-of-process address is located.", "default": "New York" }, "entityType": { "title": "Entity type (mode=byEntityType)", "enum": [ "DOMESTIC LIMITED LIABILITY COMPANY", "DOMESTIC BUSINESS CORPORATION", "DOMESTIC NOT-FOR-PROFIT CORPORATION", "FOREIGN LIMITED LIABILITY COMPANY", "FOREIGN BUSINESS CORPORATION", "DOMESTIC PROFESSIONAL SERVICE CORPORATION", "DOMESTIC PROFESSIONAL SERVICE LIMITED LIABILITY COMPANY", "FOREIGN LIMITED PARTNERSHIP", "DOMESTIC LIMITED PARTNERSHIP", "FOREIGN NOT-FOR-PROFIT CORPORATION", "DOMESTIC REGISTERED LIMITED LIABILITY PARTNERSHIP", "DOMESTIC NOT-FOR-PROFIT CORPORATION (HOUSING DEVELOPMENT FUND COMPANY) (ARTICLE XI)", "FOREIGN PROFESSIONAL SERVICE CORPORATION", "DOMESTIC BENEVOLENT ORDER", "FOREIGN PROFESSIONAL SERVICE LIMITED LIABILITY COMPANY", "DOMESTIC BENEFIT CORPORATION", "DOMESTIC HOUSING DEVELOPMENT FUND COMPANY (ARTICLE XI)", "FOREIGN GENERAL ASSOCIATION", "DOMESTIC COOPERATIVE CORPORATION", "NEW YORK REGISTERED FOREIGN LIMITED LIABILITY PARTNERSHIP", "DOMESTIC GENERAL ASSOCIATION", "DOMESTIC RELIGIOUS CORPORATION", "DOMESTIC TRANSPORTATION CORPORATION", "DOMESTIC DESIGN PROFESSIONAL SERVICE CORPORATION", "DOMESTIC NOT-FOR-PROFIT CORPORATION (BOARD OF TRADE AND CHAMBER OF COMMERCE CORPORATION)", "DOMESTIC NOT-FOR-PROFIT CORPORATION (UNIVERSITY FACULTY PRACTICE CORPORATION)", "DOMESTIC PUBLIC BENEFIT CORPORATION", "DOMESTIC NOT-FOR-PROFIT CORPORATION (COMMUNITY MENTAL HEALTH SERVICES AND MENTAL RETARDATION SERVICES COMPANIES)", "DOMESTIC NOT-FOR-PROFIT CORPORATION (LOCAL DEVELOPMENT CORPORATION)", "DOMESTIC LIMITED-PROFIT HOUSING COMPANY (ARTICLE 2 PHFL & NPCL)", "DOMESTIC COOPERATIVE CORPORATION (WORKER COOPERATIVE)", "DOMESTIC REDEVELOPMENT COMPANY (ARTICLE V)", "DOMESTIC NOT-FOR-PROFIT CORPORATION (LAND BANK)", "DOMESTIC NOT-FOR-PROFIT CORPORATION (FIRE CORPORATION)", "DOMESTIC REDEVELOPMENT COMPANY (LIMITED LIABILITY COMPANY)", "DOMESTIC JOINT STOCK ASSOCIATION", "UNAUTHORIZED FOREIGN BUSINESS CORPORATION", "DOMESTIC LIMITED-PROFIT HOUSING COMPANY (ARTICLE 2 PHFL & BCL)", "DOMESTIC NOT-FOR-PROFIT CORPORATION (PUBLIC CEMETERY CORPORATION)", "DOMESTIC NOT-FOR-PROFIT CORPORATION (MILITIA ASSOCIATION)", "DOMESTIC RAILROAD CORPORATION", "DOMESTIC GOVERNMENTAL AGENCY", "GENERAL ASSOCIATION DESIGNATION", "DOMESTIC REDEVELOPMENT COMPANY (LIMITED PARTNERSHIP)", "DOMESTIC RELIGIOUS CORPORATION (GOVERNING OR ADVISORY BODY)", "UNAUTHORIZED BUSINESS CORPORATION", "DOMESTIC CONDOMINIUM DECLARATION", "FOREIGN DESIGNATION OF THE SECRETARY OF STATE", "RESERVATION OF DOMESTIC NOT FOR PROFIT CORPORATION", "UNAUTHORIZED FOREIGN LIMITED LIABILITY COMPANY", "FOREIGN COOPERATIVE CORPORATION", "FOREIGN RELIGIOUS CORPORATION", "DOMESTIC CONDOMINIUM" ], "type": "string", "description": "Type of business entity, as recorded by NY DOS.", "default": "DOMESTIC LIMITED LIABILITY COMPANY" }, "jurisdiction": { "title": "Jurisdiction (mode=byJurisdiction)", "enum": [ "New York", "Delaware", "New Jersey", "Florida", "California", "Pennsylvania", "Connecticut", "Nevada", "Texas", "Massachusetts", "Illinois", "Ohio", "Maryland", "Wyoming", "Georgia", "Virginia", "Michigan", "Colorado", "North Carolina", "Minnesota", "Missouri", "Washington", "Indiana", "District of Columbia", "Arizona", "Tennessee", "Wisconsin", "Vermont", "Utah", "New Hampshire", "Oregon", "South Carolina", "Maine", "Kentucky", "Louisiana", "Rhode Island", "Oklahoma", "Kansas", "Alabama", "Iowa", "Alaska", "Nebraska", "New Mexico", "Arkansas", "Idaho", "Montana", "West Virginia", "South Dakota", "Mississippi", "Hawaii", "North Dakota", "Puerto Rico", "Guam", "American Samoa", "U.S. Virgin Islands", "U.S. Minor Outlying Islands", "Ontario", "Quebec", "British Columbia", "Alberta", "New Brunswick", "Nova Scotia", "Manitoba", "Prince Edward Island", "Newfoundland", "Saskatchewan", "Northwest Territories", "Nunavut", "England", "England-Wales", "Scotland", "Wales", "Northern Ireland", "Marshall Islands", "Palau", "Federated States of Micronesia", "Canal Zone", "Caroline Islands", "Wake Island", "Armed Forces Pacific", "Armed Forces (Africa, Canada, Europe, Middle East)" ], "type": "string", "description": "State, US territory, Canadian province, or country where the entity was originally formed (New York = domestic; anything else = foreign).", "default": "Delaware" }, "city": { "title": "City (mode=byCity)", "type": "string", "description": "City of the entity's service-of-process address, e.g. `BROOKLYN`.", "default": "BROOKLYN" }, "cityMatchType": { "title": "City match type (mode=byCity)", "enum": [ "startsWith", "contains" ], "type": "string", "description": "How `city` is matched.", "default": "startsWith" }, "officerName": { "title": "Officer/CEO name (mode=byOfficerName)", "type": "string", "description": "Officer/chairman/CEO name on file to search for. Only populated for a subset of entities (mostly not-for-profits and older filings)." }, "officerMatchType": { "title": "Officer name match type (mode=byOfficerName)", "enum": [ "startsWith", "contains" ], "type": "string", "description": "How `officerName` is matched.", "default": "contains" }, "zipCode": { "title": "ZIP code (mode=byZipCode)", "type": "string", "description": "5-digit US ZIP code of the entity's service-of-process address, e.g. `10001`. ZIP+4 is accepted and truncated to 5 digits.", "default": "10001" }, "state": { "title": "State (mode=byState)", "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" ], "type": "string", "description": "US state/territory (2-letter postal code) of the entity's service-of-process address. Note this is the mailing-address state, not the jurisdiction of formation -- use `byJurisdiction` for that.", "default": "NY" }, "formationDateFrom": { "title": "Formation date from (all modes)", "type": "string", "description": "Optional: only include entities formed/registered on or after this date, format `YYYY-MM-DD`." }, "formationDateTo": { "title": "Formation date to (all modes)", "type": "string", "description": "Optional: only include entities formed/registered on or before this date, format `YYYY-MM-DD`." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on emitted records.", "default": 25 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```