{ "openapi": "3.0.1", "info": { "title": "Secretary of State Business Entity Search & New LLC Filings", "description": "Secretary of State business entity search and KYB lookup by name or ID, plus a feed of new business filings (new LLCs and corporations) from official open data in Colorado, Connecticut, New York, Oregon and Pennsylvania. Filter by type, city, ZIP. Delta alerts. No API key. $0.003 per business.", "version": "0.1", "x-build-id": "bsf6Qswx0hkdh7Fb3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/wantmannu~us-state-business-registry/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-wantmannu-us-state-business-registry", "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/wantmannu~us-state-business-registry/runs": { "post": { "operationId": "runs-sync-wantmannu-us-state-business-registry", "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/wantmannu~us-state-business-registry/run-sync": { "post": { "operationId": "run-sync-wantmannu-us-state-business-registry", "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": "\"New business filings\" lists LLCs, corporations and other entities formed or registered in the date window (lead lists, market monitoring). \"Look up\" finds specific entities by state ID number or by name.", "default": "newFilings" }, "states": { "title": "States", "type": "array", "description": "Which state registries to search. Leave empty for all five. Colorado, Connecticut and New York update daily, Oregon weekly, Pennsylvania monthly.", "items": { "type": "string", "enum": [ "CO", "CT", "NY", "OR", "PA" ], "enumTitles": [ "Colorado", "Connecticut", "New York", "Oregon", "Pennsylvania" ] } }, "lastNDays": { "title": "Formed in the last N days", "minimum": 1, "maximum": 366, "type": "integer", "description": "Window ending today (US Eastern time). Ignored if \"Formed from\" is set. Oregon updates weekly and Pennsylvania monthly, so use 14–45 days for those.", "default": 7 }, "dateFrom": { "title": "Formed from", "type": "string", "description": "Start of the formation/registration date range (YYYY-MM-DD). Overrides \"last N days\"." }, "dateTo": { "title": "Formed to", "type": "string", "description": "End of the date range (YYYY-MM-DD). Defaults to today." }, "entityKinds": { "title": "Entity kinds", "type": "array", "description": "Keep only these kinds of entity. Leave empty for all.", "items": { "type": "string", "enum": [ "llc", "corporation", "nonprofit", "partnership", "other" ], "enumTitles": [ "LLC", "Corporation (incl. professional & benefit)", "Nonprofit", "Partnership (LP, LLP, LLLP)", "Other" ] } }, "domesticOnly": { "title": "Domestic entities only", "type": "boolean", "description": "Skip foreign entities, i.e. companies formed in another state that registered to do business here. Turn on to get truly new local businesses.", "default": false }, "activeOnly": { "title": "Active entities only", "type": "boolean", "description": "Skip dissolved, withdrawn and rejected filings (relevant for Colorado and Connecticut; the New York, Oregon and Pennsylvania datasets list active entities only).", "default": true }, "cities": { "title": "Cities", "type": "array", "description": "Keep only businesses whose address is in one of these cities, e.g. \"Denver\", \"Brooklyn\", \"Portland\". Case-insensitive exact match.", "items": { "type": "string" } }, "zipPrefixes": { "title": "ZIP code prefixes", "type": "array", "description": "Keep only businesses whose ZIP code starts with one of these, e.g. \"802\" (Denver area) or \"10001\".", "items": { "type": "string" } }, "nameIncludes": { "title": "Name contains", "type": "array", "description": "Keep only businesses whose name contains any of these words, e.g. \"dental\", \"roofing\", \"capital\". Case-insensitive.", "items": { "type": "string" } }, "nameExcludes": { "title": "Name does not contain", "type": "array", "description": "Drop businesses whose name contains any of these words, e.g. \"holdings\", \"trust\".", "items": { "type": "string" } }, "includeNameFilings": { "title": "Include assumed business names (DBAs)", "type": "boolean", "description": "Oregon also lists assumed business names (DBAs). They are not new legal entities, so they're skipped unless you turn this on.", "default": false }, "entityIds": { "title": "Entity IDs (lookup mode)", "type": "array", "description": "State ID numbers, ideally with a state prefix: \"CO:20261234567\", \"NY:8047933\", \"OR:263936297\", \"CT:3535333\" (account number), \"PA:0006901395\" (filing number). Without a prefix every selected state is searched.", "items": { "type": "string" } }, "names": { "title": "Business names (lookup mode)", "type": "array", "description": "Find businesses whose name contains this text, in every selected state, newest first. At least 3 characters.", "items": { "type": "string" } }, "maxResultsPerName": { "title": "Max results per name and state", "minimum": 1, "maximum": 100, "type": "integer", "description": "Lookup mode: how many matches to keep for each name in each state.", "default": 10 }, "includeContacts": { "title": "Add registered agent & principals", "type": "boolean", "description": "Add the registered agent (name, role, address) and the principals listed on the public record: officers in Connecticut and Pennsylvania, authorized representatives in Oregon, chairman/CEO in New York. Colorado publishes the agent only. These are often private individuals: use them lawfully (e.g. CAN-SPAM, TCPA, state privacy laws) and don't use them for unsolicited calls or texts. Residential addresses of principals are never collected.", "default": false }, "maxPrincipals": { "title": "Max principals per business", "minimum": 1, "maximum": 50, "type": "integer", "description": "Upper limit on principals per record when contacts are on.", "default": 10 }, "addSummary": { "title": "Add one-line summary", "type": "boolean", "description": "Adds a short plain-English sentence per business, e.g. \"ACME LLC: Colorado domestic LLC formed 18 Oct 2026 in Denver, CO; status: Good Standing.\" Built by fixed rules, not an AI model, so there's no extra cost.", "default": false }, "maxResults": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Maximum number of business records to save (you pay per record). Newest filings across all selected states come first.", "default": 100 }, "maxResultsPerState": { "title": "Max results per state", "minimum": 0, "type": "integer", "description": "Optional cap per state so a big state (New York files 1,000+ a day) doesn't fill the whole quota. 0 = no cap.", "default": 0 }, "deltaMode": { "title": "Delta mode (only new records)", "type": "boolean", "description": "Remember which businesses were already delivered for these filters and skip them next time. Use it with a daily schedule for a new-business alert.", "default": false }, "deltaStoreName": { "title": "Delta store name", "type": "string", "description": "Named key-value store that keeps delta state. Use a different name per alert if you want separate histories.", "default": "us-business-registry-delta" }, "socrataAppToken": { "title": "Socrata app token (optional)", "type": "string", "description": "Not needed. A free app token from any of the state portals raises rate limits for very large runs." } } }, "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 } } } } } } } } } }