{ "openapi": "3.0.1", "info": { "title": "New Business Filings: Colorado and New York Companies", "description": "Newly formed LLCs, corporations and nonprofits from Colorado and New York Secretary of State registries. Filter by date, entity type, city. Records include business name, formation date and status. Colorado adds address and ZIP. Ready for accountants targeting new filers and sales teams.", "version": "0.1", "x-build-id": "BzgT1u2Em47QTqpXY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ledgerstar~state-business-filings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ledgerstar-state-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/ledgerstar~state-business-filings/runs": { "post": { "operationId": "runs-sync-ledgerstar-state-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/ledgerstar~state-business-filings/run-sync": { "post": { "operationId": "run-sync-ledgerstar-state-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": "Registries to search. Results are split evenly across the selected states.", "items": { "type": "string", "enum": [ "CO", "NY" ], "enumTitles": [ "Colorado", "New York" ] }, "default": [ "CO", "NY" ] }, "daysBack": { "title": "Formed in the last N days", "minimum": 1, "maximum": 36500, "type": "integer", "description": "Look back this many days from today. Ignored when 'Formed on or after' is set.", "default": 30 }, "filedSince": { "title": "Formed on or after (optional)", "type": "string", "description": "Exact start date (YYYY-MM-DD). Overrides 'last N days'." }, "newSince": { "title": "Alert mode: only filings new since (optional)", "type": "string", "description": "Turns on alert mode: only return filings formed on or after this date. Use an exact date (YYYY-MM-DD) or the word lastRun to return only filings formed since the previous successful run. Leave empty to turn alert mode off and use the settings above instead." }, "alertLookbackDays": { "title": "Alert mode: lookback days (optional)", "minimum": 1, "maximum": 30, "type": "integer", "description": "Only used with newSince set to lastRun. Widens the check to this many days before the previous run's start, so a filing the source posts a few days late is still delivered. You are never charged twice for the same filing. Default 7, minimum 1, maximum 30.", "default": 7 }, "entityCategories": { "title": "Entity types (optional)", "type": "array", "description": "Leave empty for all types.", "items": { "type": "string", "enum": [ "LLC", "Corporation", "Nonprofit", "Partnership", "Other" ] } }, "domesticOnly": { "title": "Home-state entities only", "type": "boolean", "description": "Skip out-of-state (foreign) entities that registered to do business in the state.", "default": false }, "cities": { "title": "Cities (optional)", "type": "array", "description": "Principal-office city, e.g. Denver, Boulder. Case-insensitive, exact city name. Colorado only — New York's registry publishes no business-location city field, so this filter has no effect on NY results.", "items": { "type": "string" } }, "zipPrefixes": { "title": "ZIP codes or prefixes (optional)", "type": "array", "description": "e.g. 80202 or 802 (Denver). Colorado only — New York's registry publishes no business-location ZIP field, so NY results are never matched by this filter.", "items": { "type": "string" } }, "maxItems": { "title": "Maximum results", "minimum": 1, "maximum": 500000, "type": "integer", "description": "Stop after this many results in total. You are charged per result.", "default": 20 }, "maxRowsScannedPerState": { "title": "Maximum source rows to scan per state", "minimum": 100, "maximum": 2000000, "type": "integer", "description": "Safety limit on raw rows read while filtering (one request per second).", "default": 20000 }, "appToken": { "title": "Socrata app token (optional)", "type": "string", "description": "Optional free app token for higher rate limits on very large pulls. Not needed for normal use." }, "alertStateKey": { "title": "Alert mode: stable state name (optional)", "pattern": "^[a-z0-9-]{1,30}$", "type": "string", "description": "Only used with alert mode (the field above). Give this a fixed name such as co ny nightly so this schedule always uses the same saved last run date, even if you change other filters. Letters, numbers and hyphens only, up to 30 characters. Leave empty to have one chosen automatically based on your filters." } } }, "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 } } } } } } } } } }