{ "openapi": "3.0.1", "info": { "title": "New Business Filings: CO, CT, NY & OR New LLCs and Corps", "description": "Newly filed LLCs, corporations, nonprofits and partnerships in Colorado, Connecticut, New York and Oregon, from each state's official open-data portal. One table with entity type, out-of-state flag, filing date, address and registered agent; optional tracking returns only filings you have not seen.", "version": "0.1", "x-build-id": "0JPRhMlPXMsSnzmIO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yzy001~new-business-filings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yzy001-new-business-filings", "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/yzy001~new-business-filings/runs": { "post": { "operationId": "runs-sync-yzy001-new-business-filings", "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/yzy001~new-business-filings/run-sync": { "post": { "operationId": "run-sync-yzy001-new-business-filings", "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": "Which states to read. Each one comes from that state's official open-data portal.", "items": { "type": "string", "enum": [ "CO", "CT", "NY", "OR" ], "enumTitles": [ "Colorado", "Connecticut", "New York", "Oregon" ] }, "default": [ "CO", "CT", "NY", "OR" ] }, "daysBack": { "title": "Days back", "minimum": 1, "maximum": 31, "type": "integer", "description": "Filings dated within the last N days, today included (1-31). The portals trail by one to three days, so a 1-day window is often empty. Ignored when a from date is set.", "default": 7 }, "fromDate": { "title": "From date", "type": "string", "description": "Optional. First filing date to include (YYYY-MM-DD). The range can cover at most 31 days." }, "toDate": { "title": "To date", "type": "string", "description": "Optional. Last filing date to include (YYYY-MM-DD). Defaults to today." }, "entityTypes": { "title": "Entity types", "type": "array", "description": "Keep only these types. Assumed business names (DBAs, Oregon only) are left out unless you add ASSUMED_NAME.", "items": { "type": "string", "enum": [ "LLC", "CORPORATION", "NONPROFIT", "PARTNERSHIP", "OTHER", "ASSUMED_NAME" ], "enumTitles": [ "LLC", "Corporation", "Nonprofit", "Partnership (LP, LLP, LLLP, GP)", "Other (cooperatives, trusts, other)", "Assumed business name (Oregon)" ] }, "default": [ "LLC", "CORPORATION", "NONPROFIT", "PARTNERSHIP", "OTHER" ] }, "includeForeign": { "title": "Include out-of-state entities", "type": "boolean", "description": "Include entities formed in another state (often Delaware) that registered to do business here. Turn off for home-state formations only.", "default": true }, "cities": { "title": "Cities", "type": "array", "description": "Optional. Keep entities whose principal address is in one of these cities (exact name, any case). New York publishes no street address, so New York rows are left out when this is set.", "default": [], "items": { "type": "string" } }, "zipPrefixes": { "title": "ZIP code prefixes", "type": "array", "description": "Optional. Keep entities whose principal address ZIP starts with one of these, for example 802 or 97209. Same New York note as cities.", "default": [], "items": { "type": "string" } }, "nameKeywords": { "title": "Name keywords", "type": "array", "description": "Optional. Keep entities whose name contains any of these words, for example dental, construction, holdings.", "default": [], "items": { "type": "string" } }, "trackChanges": { "title": "Track what you have already received", "type": "boolean", "description": "Remember the entities returned by earlier tracked runs (120 days, in a key-value store named new-business-filings-state in your account) and mark each row NEW or SEEN.", "default": false }, "onlyNew": { "title": "Only filings not seen before", "type": "boolean", "description": "With tracking on, leave out entities an earlier tracked run already returned. Good for a daily schedule with a 7-day window, which also catches filings the state published late.", "default": false }, "allowPartial": { "title": "Allow partial results", "type": "boolean", "description": "On by default: if one state's portal cannot be read, the others are still returned and the status message names it. Turn off to make any failed state fail the run.", "default": true }, "maxItems": { "title": "Maximum rows", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Upper bound on rows returned, newest filings first. A 7-day window across all four states is roughly 4,000-5,000 rows.", "default": 10000 } } }, "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 } } } } } } } } } }