{ "openapi": "3.0.1", "info": { "title": "US New Business Registrations", "description": "Newly registered LLCs, corporations and nonprofits from Colorado, Connecticut, New York, Oregon, Pennsylvania and Texas, plus Secretary of State business entity search (KYB) by name or ID. Official state open data, one schema, no personal names.", "version": "0.2", "x-build-id": "PwHiuaDPsdhM2brbs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cpt_engineering~us-business-registrations-open-data/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cpt_engineering-us-business-registrations-open-data", "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/cpt_engineering~us-business-registrations-open-data/runs": { "post": { "operationId": "runs-sync-cpt_engineering-us-business-registrations-open-data", "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/cpt_engineering~us-business-registrations-open-data/run-sync": { "post": { "operationId": "run-sync-cpt_engineering-us-business-registrations-open-data", "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": { "mode": { "title": "Mode", "enum": [ "newFilings", "lookup" ], "type": "string", "description": "newFilings: return business entities (LLCs, corporations, nonprofits, partnerships) formed in a date window, oldest first. lookup: find existing entities by name and/or state-assigned ID; needs 'names' or 'entityIds'.", "default": "newFilings" }, "states": { "title": "States", "type": "array", "description": "Two-letter codes of the state registries to query. Supported: CO, CT, NY, OR, PA, TX. Empty = all supported states. Freshness differs by state: CO, CT, NY daily; OR weekly; PA about 2 weeks behind; TX 3-5 weeks behind (see README).", "items": { "type": "string", "enum": [ "CO", "CT", "NY", "OR", "PA", "TX" ], "enumTitles": [ "Colorado", "Connecticut", "New York", "Oregon", "Pennsylvania", "Texas" ] }, "default": [ "CO", "CT", "NY", "OR", "PA", "TX" ] }, "lastNDays": { "title": "Formed in the last N days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "newFilings only. Window size in days counted back from today, e.g. 7 = new this week, 1 = since yesterday, 30 = last month. Used when 'Formed on or after' is empty and there is no saved progress from an earlier run (see 'Only new since last run').", "default": 7 }, "sinceDate": { "title": "Formed on or after (YYYY-MM-DD)", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "newFilings only. Exact start date, ISO format YYYY-MM-DD, e.g. 2026-09-01. Returns entities whose formation/registration date is on or after this date and not in the future. Overrides 'Formed in the last N days' and 'Only new since last run'." }, "onlyNewSinceLastRun": { "title": "Only new since last run", "type": "boolean", "description": "newFilings only. true: remember what this Actor already returned to you (per state, in a named key-value store on your account) and return only entities not returned before, including late-published filings. Turn it on for scheduled daily/weekly runs and tasks. false (default): always return the full window, so test runs are repeatable. Ignored when 'Formed on or after' is set.", "default": false }, "entityTypes": { "title": "Entity types", "type": "array", "description": "Optional filter on the normalized entity type. Allowed values: LLC, CORPORATION, NONPROFIT, PARTNERSHIP, OTHER. Empty = all types.", "items": { "type": "string", "enum": [ "LLC", "CORPORATION", "NONPROFIT", "PARTNERSHIP", "OTHER" ], "enumTitles": [ "LLC", "Corporation", "Nonprofit", "Partnership", "Other" ] }, "default": [] }, "includeForeign": { "title": "Include foreign entities", "type": "boolean", "description": "true: also return out-of-state or foreign companies newly registered to do business in the state. false: only entities formed in that state (domestic).", "default": true }, "zipCodes": { "title": "ZIP codes or prefixes", "type": "array", "description": "Optional. Keep only entities whose principal-office ZIP starts with any of these, e.g. ['80202'] for one ZIP or ['802'] for the Denver area. Applied after download, so narrow filters over long windows read more pages (still billed only per returned record). Empty = all.", "items": { "type": "string" }, "default": [] }, "cities": { "title": "Cities", "type": "array", "description": "Optional. Keep only entities whose principal-office city matches one of these exactly (case-insensitive), e.g. ['Denver', 'Boulder']. Empty = all.", "items": { "type": "string" }, "default": [] }, "names": { "title": "Company names (lookup)", "type": "array", "description": "lookup only. Case-insensitive 'contains' match on the registered entity name, e.g. 'acme robotics'. Several names = OR.", "items": { "type": "string" }, "default": [] }, "entityIds": { "title": "State entity IDs (lookup)", "type": "array", "description": "lookup only. Exact state-assigned entity/file numbers. Prefix with the state to target one registry, e.g. 'CO:20261234567', 'NY:8042889', 'PA:0015846315', 'TX:0806661893'. Unprefixed IDs are tried in every selected state.", "items": { "type": "string" }, "default": [] }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 200000, "type": "integer", "description": "Maximum entity records returned (and charged) in total, split evenly across the selected states, e.g. 100 with 6 states = up to 17 per state. Raise it for full daily or weekly lists.", "default": 100 }, "includeStreetAddress": { "title": "Include street line of business address", "type": "boolean", "description": "false (default): only city, state and ZIP of the entity's principal office. true: also the street line as filed with the state (CO, CT, NY, OR, PA; never for TX). Some small businesses list a home address, so leave it off unless you need it.", "default": false }, "socrataAppToken": { "title": "Socrata app token (optional)", "type": "string", "description": "Optional free app token from a state open-data portal. Only useful for very large pulls; not required." } } }, "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 } } } } } } } } } }