{ "openapi": "3.0.1", "info": { "title": "US State Business Entity Registry API (Unofficial)", "description": "Search registered businesses in Colorado, Connecticut and New York: entity ID, name, type, status, formation date, city, ZIP. Filter by name, date, city, ZIP or category. Public open data, no API key. No agents, officers, contact data or sole proprietors. Not affiliated with any state agency.", "version": "0.1", "x-build-id": "1fX2dZ6DH1YGSDGuA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/graylabs~us-state-business-entities/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-graylabs-us-state-business-entities", "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/graylabs~us-state-business-entities/runs": { "post": { "operationId": "runs-sync-graylabs-us-state-business-entities", "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/graylabs~us-state-business-entities/run-sync": { "post": { "operationId": "run-sync-graylabs-us-state-business-entities", "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: CO (Colorado), CT (Connecticut), NY (New York, active entities only). maxResults is shared evenly between the states; room one state does not use goes to the next.", "items": { "type": "string", "enum": [ "CO", "CT", "NY" ], "enumTitles": [ "Colorado", "Connecticut", "New York" ] }, "default": [ "CO", "CT", "NY" ] }, "name": { "title": "Entity name contains", "type": "string", "description": "Optional. Words in the registered entity name, e.g. 'bakery'. Case-insensitive. Only the entity's own name is searched." }, "entityIds": { "title": "Entity IDs", "type": "array", "description": "Optional. Look up specific entities: Colorado entity IDs, Connecticut account numbers or New York DOS IDs (up to 1,000). Each ID is looked up in every selected state. Other filters are ignored in this mode, except status.", "default": [], "items": { "type": "string" } }, "entityCategories": { "title": "Entity categories", "type": "array", "description": "Optional. llc, corporation, nonprofit, partnership, cooperative or other. Default: all.", "items": { "type": "string", "enum": [ "llc", "corporation", "nonprofit", "partnership", "cooperative", "other" ], "enumTitles": [ "LLC", "Corporation", "Nonprofit", "Partnership", "Cooperative", "Other" ] }, "default": [] }, "formedFrom": { "title": "Formed from", "type": "string", "description": "Optional. Earliest formation or registration date (YYYY-MM-DD). Use it with sort = newest to follow new registrations." }, "formedTo": { "title": "Formed to", "type": "string", "description": "Optional. Latest formation or registration date (YYYY-MM-DD)." }, "cities": { "title": "Cities", "type": "array", "description": "Optional. City of the business address, exact name, e.g. Denver, New Haven, Brooklyn. Case-insensitive.", "default": [], "items": { "type": "string" } }, "zipCodes": { "title": "ZIP codes", "type": "array", "description": "Optional. 5-digit ZIP codes of the business address, e.g. 80202.", "default": [], "items": { "type": "string" } }, "status": { "title": "Status", "enum": [ "active", "any" ], "type": "string", "description": "Active (default): only entities that currently exist (CO: Good Standing, Exists, Delinquent, Noncompliant; CT: Active, Recorded, Registered). Any: include dissolved, withdrawn, merged and other inactive entities (CO and CT only; the New York dataset lists active entities only).", "default": "active" }, "sort": { "title": "Order", "enum": [ "newest", "oldest", "name" ], "type": "string", "description": "Newest formation date first (default), oldest first, or by name.", "default": "newest" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after saving this many entities (each saved entity is one charged result).", "default": 100 }, "maxRequests": { "title": "Max requests", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Safety cap on requests to the sources (each returns up to 1,000 records).", "default": 500 } } }, "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 } } } } } } } } } }