{ "openapi": "3.0.1", "info": { "title": "US Secretary of State Business Search (NY, CO, OR, CT)", "description": "Search official US state business registers for KYB checks and new LLC lists: New York, Colorado, Oregon and Connecticut. Official open data, one consistent schema, every record links to the state source.", "version": "0.0", "x-build-id": "chQfBrbYTEYs4cKay" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/groundtruth~us-state-business-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-groundtruth-us-state-business-search", "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/groundtruth~us-state-business-search/runs": { "post": { "operationId": "runs-sync-groundtruth-us-state-business-search", "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/groundtruth~us-state-business-search/run-sync": { "post": { "operationId": "run-sync-groundtruth-us-state-business-search", "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": { "query": { "title": "Company name contains", "type": "string", "description": "Part of a legal business name, for example 'acme' or 'blue ridge bakery'. Matching ignores upper and lower case. Leave empty if you search by entity number or only want newly formed businesses. Defaults to 'bakery' so the Actor has a working example run.", "default": "bakery" }, "entity_numbers": { "title": "Entity numbers (optional)", "type": "array", "description": "Look up specific entities by the state's own entity number, digits only. Numbers are not unique across states (New York and Connecticut both issue seven-digit numbers), so pick the state too.", "items": { "type": "string" } }, "states": { "title": "States to search", "type": "array", "description": "Leave empty to search all four. Results are shared across the states you pick.", "items": { "type": "string", "enum": [ "NY", "CO", "OR", "CT" ], "enumTitles": [ "New York", "Colorado", "Oregon", "Connecticut" ] }, "default": [ "NY", "CO", "OR", "CT" ] }, "formed_after": { "title": "Formed on or after (optional)", "type": "string", "description": "Date as YYYY-MM-DD. Use it for a list of newly formed businesses, for example 2026-10-01. Results are sorted newest first." }, "formed_before": { "title": "Formed on or before (optional)", "type": "string", "description": "Date as YYYY-MM-DD. Combine with 'Formed on or after' for a date window." }, "entity_kind": { "title": "Kind of entity", "enum": [ "any", "llc", "corporation", "nonprofit", "partnership" ], "type": "string", "description": "Limit results to one kind of business. 'Any' returns every kind the register holds.", "default": "any" }, "status": { "title": "Status", "enum": [ "any", "active", "active_or_delinquent", "inactive" ], "type": "string", "description": "'Any' returns every status the state publishes. New York and Oregon publish active entities only, so a search for inactive ones skips them. 'Delinquent' means still registered but behind on filings, or already warned by the state.", "default": "any" }, "max_results": { "title": "Maximum entities", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Total entities to return, shared across the selected states. You are charged per entity returned.", "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 }, "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 } } } } } } } } } }