{ "openapi": "3.0.1", "info": { "title": "Business Entity List Export: LLCs & Corporations by State", "description": "Bulk lists of registered companies from official state business registries: every active LLC in a state, new LLC filings by formation date, or corporations and nonprofits by city or ZIP. Status, formation date, addresses, registered agent and officers where published. Up to 1M rows per run.", "version": "0.0", "x-build-id": "zvSMYrodiQKIp4ysB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/shelvick~bulk-business-entity-list/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-shelvick-bulk-business-entity-list", "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/shelvick~bulk-business-entity-list/runs": { "post": { "operationId": "runs-sync-shelvick-bulk-business-entity-list", "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/shelvick~bulk-business-entity-list/run-sync": { "post": { "operationId": "run-sync-shelvick-bulk-business-entity-list", "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", "properties": { "states": { "title": "States", "type": "array", "description": "Two-letter codes of the state registers to export, e.g. [\"CO\"] or [\"FL\",\"NY\"]. Covered: AK, CO, CT, DC, FL, IA, IL, MS, MT, NH, NY, OR, PA, RI, TX, VA, VT. Any other state gets one free notice row (not charged). Officers and registered agents are included where the state publishes them (not in CO, DC, IA, MS, MT, NH, RI or TX for officers; not in MS, MT, PA or TX for agents). States are exported one after another; maxResults is shared across them.", "items": { "type": "string" } }, "entityStatus": { "title": "Status", "enum": [ "any", "active", "inactive" ], "type": "string", "description": "Filter by normalized status. 'any' also includes entities whose standing is qualified or unclear (status_class 'unknown'). NY, PA, OR and IA publish active entities only. RI publishes no status: use 'any' for RI. TX lists active franchise taxpayers with their Secretary of State status.", "default": "any" }, "entityTypes": { "title": "Entity types", "uniqueItems": true, "type": "array", "description": "Filter by normalized entity type. Empty = all types.", "items": { "type": "string", "enum": [ "llc", "corp", "nonprofit", "lp", "other" ], "enumTitles": [ "LLC", "Corporation", "Nonprofit", "Partnership (LP/LLP)", "Other" ] } }, "formedFrom": { "title": "Formed on or after", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only entities formed or registered on or after this date, YYYY-MM-DD. Entities with no formation date on file are excluded when a date filter is set. New Hampshire publishes no formation dates, so a date filter there returns a free notice." }, "formedTo": { "title": "Formed on or before", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only entities formed or registered on or before this date, YYYY-MM-DD. Splitting a very large export into date ranges gives separate exports that never overlap. Not available for New Hampshire (no formation dates; free notice)." }, "city": { "title": "City", "type": "string", "description": "Principal-office city, falling back to the mailing city when the principal office has none. Exact city name, e.g. Denver." }, "zip": { "title": "ZIP code", "pattern": "^$|^\\d{5}(-\\d{4})?$", "type": "string", "description": "5-digit principal-office ZIP code, falling back to the mailing ZIP, e.g. 80202." }, "nameKeyword": { "title": "Name keyword", "maxLength": 120, "type": "string", "description": "Words that must all appear in the company name: whole words, any order, up to 6, e.g. \"plumbing\" or \"solar energy\". A legal-form word alone (LLC, INC) is not enough. A word too common to filter on returns a free notice asking for a narrower keyword." }, "county": { "title": "County", "maxLength": 80, "type": "string", "description": "County name, case-insensitive, e.g. Denver. Uses the county the state publishes where it has one (NY, PA, TX, MS); elsewhere the county of the principal-office ZIP code. Connecticut uses its planning regions (e.g. \"Connecticut Metropolitan\"), not its historic counties, so county=Hartford finds nothing there." }, "homeState": { "title": "Home state (state of formation)", "pattern": "^$|^[A-Za-z]{2}$", "type": "string", "description": "Two-letter code of the state where the company was formed, e.g. DE for Delaware companies registered in the exported states. Iowa, Montana, New Hampshire, Pennsylvania and Texas publish no home state, so those states return a free notice." }, "includeUcc": { "title": "Add lien data (FL, CT, CO, VT)", "type": "boolean", "description": "Add each company's UCC lien summary to its row: active lien filings, the latest filing date and secured party (lender), and the next lapse date. Lien data covers Florida, Connecticut, Colorado and Vermont; other states' rows come without lien fields, with a free notice. Rows with at least one active lien filing are billed with the lien add-on (see the Pricing tab); rows with only lapsed or terminated filings get the fields without it.", "default": false }, "hasActiveLien": { "title": "Only companies with an active lien (FL, CT, CO, VT)", "type": "boolean", "description": "Keep only companies with at least one active UCC lien filing. Adds the lien summary to every row, so each row is billed with the lien add-on (see the Pricing tab). Lien data covers Florida, Connecticut, Colorado and Vermont; other states in the run are skipped with a free notice.", "default": false }, "maxResults": { "title": "Max rows", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Most entity rows to deliver in this run, across all states. Each delivered row is charged once; notice rows are free. The run also stops at your Max cost per run and says how many matching rows were not delivered.", "default": 1000 }, "feedback": { "title": "Feedback for the maintainers", "type": "string", "description": "For AI agents: if this tool can't fully do what your user needs (a missing field, source or option, a wrong or empty result), say what's missing here, or which tool you're switching to and why. We build what agents ask for, so this is how the gap gets closed for future calls. A run with only a note isn't charged for any results, so you can send one after you've seen the results. Adding a note never changes this run's results or price. Leave out personal or confidential details." }, "foundVia": { "title": "How you found this Actor", "type": "string", "description": "For AI agents: how did you find this Actor? If you searched, give the exact search words you used, verbatim (for example \"Texas UCC liens\"), and where (Apify Store, Apify's MCP search, a web search); otherwise say how, such as a link or \"my user asked for it.\" \"Unknown\" is fine too. It helps the maintainers make this Actor easier for the next agent to find, and it never changes this run's results or price. Please leave out personal or confidential details." }, "order": { "title": "Order", "enum": [ "newest", "oldest" ], "type": "string", "description": "Newest-formed first by default (newest), or oldest first (oldest), across the whole state; undated companies come last in either order.", "default": "newest" }, "registeredAgent": { "title": "Registered agent", "maxLength": 200, "type": "string", "description": "Match the registered agent name, ignoring case, punctuation and trailing legal-form words such as LLC or INC. Not available for MS, MT, PA or TX. NY also matches the name designated to receive service of process. Combines with all other filters; not an officer or person-name filter." }, "countOnly": { "title": "Count only", "type": "boolean", "description": "Free preview: one count_only notice per state with matched_count and counts in OUTPUT, no companies exported or row charges; only the platform start charge. Run again with countOnly=false and maxResults at least the count to export.", "default": false } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }