{ "openapi": "3.0.1", "info": { "title": "Vermont SOS Business Registration Search Scraper", "description": "Verify one or more companies against Vermont's Secretary of State Business Registration registry by exact name. Returns entity status, entity type, entity number, name-change history, and registered-agent history.", "version": "1.0", "x-build-id": "775kf1uFZbZcTtASl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~vermont-sos-business-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-vermont-sos-business-search-scraper", "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/crawlerbros~vermont-sos-business-search-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-vermont-sos-business-search-scraper", "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/crawlerbros~vermont-sos-business-search-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-vermont-sos-business-search-scraper", "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": [ "businessNames" ], "properties": { "businessNames": { "title": "Business name(s) to look up", "type": "array", "description": "One or more exact (or near-exact) Vermont-registered business names to verify, e.g. \"Ben & Jerry's Homemade, Inc.\". Vermont's registry matches on a normalized form of the full registered name (short legal-suffix abbreviations like \"Inc.\" are tolerated, but the name must otherwise match -- this is an exact lookup, not a fuzzy/partial search). Provide multiple names to batch-check several companies in one run.", "items": { "type": "string" } }, "statusFilter": { "title": "Filter by entity status", "enum": [ "", "Active", "Active - Expiration Pending", "Active - Hold", "Active - In Good Standing", "Active - In Good Standing - Pending Conversion", "Active - In Good Standing - Pending Domestication", "Active - In Good Standing - Pending Merger", "Active - In Good Standing - Pending Redomestication", "Active - NOT In Good Standing", "Active - Registered", "Active - Reserved", "Active registered - Reregistration Pending", "Cancelled", "Cessated", "Dissolved", "Inactive", "Inactive - Administratively Dissolved", "Inactive - Administratively Revoked", "Inactive - Administratively Terminated", "Inactive - Cancelled", "Inactive - Cessated", "Inactive - Converted", "Inactive - Dissolved", "Inactive - Domesticated", "Inactive - Expired", "Inactive - Judicially Terminated", "Inactive - Merged", "Inactive - Non-Sufficient Funds", "Inactive - Redomisticated", "Inactive - Withdrawn", "Inactive-Revoked", "Pending Cancellation", "Pending Cessation", "Pending Revocation", "Pending Safety Inspection", "Pending Withdrawal", "Revoked", "Terminated", "Withdrawn" ], "type": "string", "description": "Only return matches with this exact registration status. Leave blank for no filter.", "default": "" }, "businessTypeFilter": { "title": "Filter by business/entity type", "enum": [ "", "Amusement Ride", "Assumed Name", "Data Broker", "Domestic Business Corporation", "Domestic Cooperative Association", "Domestic Limited Liability Company", "Domestic Limited Partnership", "Domestic Mutual Benefit Enterprise", "Domestic Nonprofit Corporation", "Domestic Partnership", "Domestic Unincorporated Nonprofit Association", "Domestic Utility Cooperative", "Foreign Business Corporation", "Foreign Limited Liability Company", "Foreign Limited Partnership", "Foreign Mutual Benefit Enterprise", "Foreign Nonprofit Corporation", "Foreign Partnership", "Foreign Unincorporated Nonprofit Association" ], "type": "string", "description": "Only return matches of this exact registered entity type. Leave blank for no filter.", "default": "" }, "includeNameHistory": { "title": "Include legal name change history", "type": "boolean", "description": "When enabled (default), fetches each matched entity's history of previous legal names and name-change filing dates, when on file.", "default": true }, "includeAgentHistory": { "title": "Include registered agent change history", "type": "boolean", "description": "When enabled (default), fetches each matched entity's history of registered-agent changes, when on file.", "default": true }, "includeOfficers": { "title": "Include officers / directors list", "type": "boolean", "description": "When enabled (default), includes each matched entity's on-file officers, directors, and other principals (name, title, address), when on file.", "default": true }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of business entity records to return.", "default": 20 } } }, "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 } } } } } } } } } }