{ "openapi": "3.0.1", "info": { "title": "New LLC & Business Registrations Feed – Colorado & Connecticut", "description": "Feed of newly registered US businesses in Colorado and Connecticut from the official Secretary of State open-data APIs. Only-new mode skips companies already delivered. Public domain data, no scraping, no personal contacts. Spreadsheet-ready.", "version": "0.1", "x-build-id": "GXw3HbdRH8qnpl7gq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/far003~us-new-business-registrations/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-far003-us-new-business-registrations", "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/far003~us-new-business-registrations/runs": { "post": { "operationId": "runs-sync-far003-us-new-business-registrations", "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/far003~us-new-business-registrations/run-sync": { "post": { "operationId": "run-sync-far003-us-new-business-registrations", "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": "Which state registers to read. Colorado (Colorado Department of State) and Connecticut (Secretary of the State). Both by default. More states are added as their open-data registers are checked; a state is only added when its data is public domain and can be read through an official API.", "items": { "type": "string", "enum": [ "CO", "CT" ], "enumTitles": [ "Colorado", "Connecticut" ] }, "default": [ "CO", "CT" ] }, "registeredFrom": { "title": "Registered from", "type": "string", "description": "First registration date to include (YYYY-MM-DD, inclusive). Leave empty for the default window: the last 7 days ending today (UTC date). If you give only \"Registered to\", the window starts 6 days before it. The date is the one recorded by the Secretary of State (formation date for businesses formed in the state, registration date for foreign ones)." }, "registeredTo": { "title": "Registered to", "type": "string", "description": "Last registration date to include (YYYY-MM-DD, inclusive). Leave empty for today (UTC date)." }, "onlyNew": { "title": "Only businesses not delivered before", "type": "boolean", "description": "Keep a memory between runs and deliver only businesses this Actor has not delivered to you before (per state and entity ID). Schedule the Actor daily with this on to get a feed of new companies, each delivered and charged once, for example {\"onlyNew\": true} in a daily Task. The memory is kept in a named key-value store in your account (\"us-new-business-registrations-memory\"), is updated only after the rows are stored, and only for rows that were delivered. Delete that store to start over. If you run more than one scheduled Task, give each its own \"Memory key\" so they do not take each other's businesses.", "default": false }, "memoryKey": { "title": "Memory key (optional)", "pattern": "^[A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])?$", "maxLength": 26, "type": "string", "description": "Only used with \"Only businesses not delivered before\". Without a key, all your runs share one memory. Give a key (letters, digits and hyphens, at most 26 characters, for example \"denver-llc\") to keep a separate memory in the store \"us-new-business-registrations-memory-\". Use one key per scheduled Task, so two Tasks with different filters never take each other's businesses. Upper and lower case are the same key. Changing the key starts a new memory." }, "entityTypes": { "title": "Entity types", "type": "array", "description": "Keep only these kinds of business. Empty = all. The categories group the states' own entity types (the README lists the grouping); \"Other\" covers everything that is not one of the first five.", "items": { "type": "string", "enum": [ "LLC", "Corporation", "Nonprofit", "LP", "LLP", "Other" ], "enumTitles": [ "LLC (limited liability company)", "Corporation (stock, profit)", "Nonprofit (non-stock)", "LP (limited partnership, incl. LLLP)", "LLP (limited liability partnership)", "Other (partnerships, trusts, cooperatives, unknown)" ] } }, "registrationKind": { "title": "Registration kind", "enum": [ "all", "domestic", "foreign" ], "type": "string", "description": "\"Domestic\" = formed in this state; \"Foreign\" = formed elsewhere and registered to do business here (not a new company, a new registration in the state); \"All\" = both. See the field registrationKind in the output; Colorado's kind is derived from its entity type code.", "default": "all" }, "cities": { "title": "Cities", "type": "array", "description": "Keep only businesses whose address city is one of these (whole name, upper or lower case does not matter, for example \"Denver\"). The address is the principal address in Colorado and the business address in Connecticut.", "items": { "type": "string" } }, "zipCodes": { "title": "ZIP codes", "type": "array", "description": "Keep only businesses whose address ZIP code starts with one of these 5-digit codes (for example \"80222\"). ZIP+4 values are shortened to 5 digits.", "items": { "type": "string" } }, "nameContains": { "title": "Name contains", "type": "array", "description": "Keep only businesses whose registered name contains at least one of these words or fragments (at least 2 characters, case does not matter), for example \"solar\" or \"roofing\".", "items": { "type": "string" } }, "statuses": { "title": "Statuses", "type": "array", "description": "Keep only businesses with one of these statuses, written as the state writes it (case does not matter). For active companies use \"Good Standing\" (Colorado) and \"Active\" (Connecticut). A brand-new registration is usually in good standing / active, but the status is not guaranteed: it is the state's status at the time of the run. Naming \"Rejected\", \"Reserved\", \"Expired Reservation\" or \"Reserved Cancel\" here delivers those rows too.", "items": { "type": "string", "enumSuggestedValues": [ "Good Standing", "Delinquent", "Voluntarily Dissolved", "Administratively Dissolved", "Withdrawn", "Noncompliant", "Revoked", "Judicially Dissolved", "Exists", "Merged", "Converted", "Registered Agent Resigned", "Effectiveness Prevented", "Dissolved (Term Expired)", "Consolidated", "Active", "Forfeited", "Dissolved", "Cancelled", "Expired Reservation", "Rejected", "Expired", "Renunciated", "Reserved", "Domesticated", "Redomesticated", "Recorded", "Consolidation", "Converted Out", "Removed", "Reserved Cancel", "Pending Withdrawal", "Registered", "Pending Filing", "Pending Merger", "Active - Pending Domestication", "Pending Conversion" ] } }, "includeRejectedAndReserved": { "title": "Include rejected and reserved filings", "type": "boolean", "description": "Connecticut's register also lists filings that never became a business: \"Rejected\" (about 4 to 5 % of its rows) and name reservations (\"Reserved\", \"Expired Reservation\", \"Reserved Cancel\"). By default they are not delivered and not charged. Turn this on to receive them too. Colorado has no such rows.", "default": false }, "maxItems": { "title": "Maximum rows", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many business rows (all states together, newest registrations first). This is also your cost cap: 1,000 rows cost 2 USD. Your account's spending limit for the run is respected as well.", "default": 1000 } } }, "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 } } } } } } } } } }