{ "openapi": "3.0.1", "info": { "title": "Secretary of State Business Entity Filings Lookup", "description": "Search and retrieve business entity filings from the Colorado Secretary of State. Returns entity name, status, type, formation date, registered agent, principal office address, and filing history. Essential for business due diligence, competitive research, and compliance monitoring.", "version": "0.1", "x-build-id": "Es86gNMvaFKnBfSfQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/slate_spool~secretary-of-state-business-entity-filings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-slate_spool-secretary-of-state-business-entity-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/slate_spool~secretary-of-state-business-entity-filings/runs": { "post": { "operationId": "runs-sync-slate_spool-secretary-of-state-business-entity-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/slate_spool~secretary-of-state-business-entity-filings/run-sync": { "post": { "operationId": "run-sync-slate_spool-secretary-of-state-business-entity-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", "required": [ "maxRecords", "requestsPerMinute", "maxRequests", "maxRunSeconds", "includeAddresses", "failOnEmpty" ], "properties": { "query": { "title": "Entity name contains", "minLength": 2, "maxLength": 100, "type": "string", "description": "Case-insensitive name fragment. Supply this or entityIds." }, "entityIds": { "title": "Colorado entity IDs", "maxItems": 100, "type": "array", "description": "Exact Secretary of State entity IDs. Takes precedence over query.", "items": { "type": "string", "pattern": "^[0-9]{1,20}$" }, "default": [ "20251473187" ] }, "status": { "title": "Entity status", "maxLength": 80, "type": "string", "description": "Optional exact status filter." }, "maxRecords": { "title": "Maximum records", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard result and metering cap.", "default": 100 }, "requestsPerMinute": { "title": "Requests per minute", "minimum": 1, "maximum": 60, "type": "integer", "description": "Polite request rate; capped at 60 and never faster than the source's one-second crawl delay.", "default": 30 }, "maxRequests": { "title": "Maximum source requests", "minimum": 1, "maximum": 100, "type": "integer", "description": "Hard source-request cost cap.", "default": 10 }, "maxRunSeconds": { "title": "Maximum run seconds", "minimum": 10, "maximum": 3600, "type": "integer", "description": "Hard wall-clock cap checked before every source request.", "default": 120 }, "useApifyProxy": { "title": "Use Apify Proxy egress", "type": "boolean", "description": "Routes requests through US residential Apify Proxy because the official source resets Apify datacenter connections. Disable only to explicitly use direct egress.", "default": true }, "proxyGroups": { "title": "Apify Proxy groups", "type": "array", "description": "Apify proxy groups. RESIDENTIAL is the safe default for the official source. Requires Use Apify Proxy egress.", "items": { "type": "string", "pattern": "^[A-Z0-9_-]+$" }, "default": [ "RESIDENTIAL" ] }, "proxyCountryCode": { "title": "Proxy country code", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "2-letter proxy country code. US is the safe default for this US government source. Requires Use Apify Proxy egress.", "default": "US" }, "includeAddresses": { "title": "Include public addresses", "type": "boolean", "description": "Include principal and registered-agent public address fields.", "default": true }, "failOnEmpty": { "title": "Fail when no records match", "type": "boolean", "description": "Emit a structured run error and fail instead of silently returning no records.", "default": true } } }, "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 } } } } } } } } } }