{ "openapi": "3.0.1", "info": { "title": "Secretary of State Business Entity Search - KYB, 50 + DC", "description": "KYB company lookup across the official business registries of all 50 states and DC. Returns the full entity record, not the search-result row: status, type, formation date, registered agent, officers with addresses, filing and name history, and UCC liens where published.", "version": "0.0", "x-build-id": "hKPtLACzZf7Hq921e" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/clearpath~us-business-entity-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-clearpath-us-business-entity-search", "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/clearpath~us-business-entity-search/runs": { "post": { "operationId": "runs-sync-clearpath-us-business-entity-search", "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/clearpath~us-business-entity-search/run-sync": { "post": { "operationId": "run-sync-clearpath-us-business-entity-search", "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": { "companyName": { "title": "Company name", "type": "string", "description": "The business to look up, for example Tesla or Acme Holdings LLC." }, "companyNames": { "title": "More company names", "type": "array", "description": "Look up several businesses in one run. Each name is searched in every state you select. Duplicates are removed.", "items": { "type": "string" } }, "states": { "title": "States", "type": "array", "description": "Which states to search. Leave empty to search every covered state (51 of them). Each run also writes a coverage record listing exactly which fields each state publishes. Indiana is much slower than the rest, so a run that includes it finishes when Indiana does.", "items": { "type": "string", "enum": [ "AK", "AL", "AR", "AZ", "CA", "CO", "CT", "DC", "DE", "FL", "GA", "HI", "IA", "ID", "IL", "IN", "KS", "KY", "LA", "MA", "MD", "ME", "MI", "MN", "MO", "MS", "MT", "NC", "ND", "NE", "NH", "NJ", "NM", "NV", "NY", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VA", "VT", "WA", "WI", "WV", "WY" ], "enumTitles": [ "Alaska (AK)", "Alabama (AL)", "Arkansas (AR)", "Arizona (AZ)", "California (CA)", "Colorado (CO)", "Connecticut (CT)", "District of Columbia (DC)", "Delaware (DE)", "Florida (FL)", "Georgia (GA)", "Hawaii (HI)", "Iowa (IA)", "Idaho (ID)", "Illinois (IL)", "Indiana (IN)", "Kansas (KS)", "Kentucky (KY)", "Louisiana (LA)", "Massachusetts (MA)", "Maryland (MD)", "Maine (ME)", "Michigan (MI)", "Minnesota (MN)", "Missouri (MO)", "Mississippi (MS)", "Montana (MT)", "North Carolina (NC)", "North Dakota (ND)", "Nebraska (NE)", "New Hampshire (NH)", "New Jersey (NJ)", "New Mexico (NM)", "Nevada (NV)", "New York (NY)", "Ohio (OH)", "Oklahoma (OK)", "Oregon (OR)", "Pennsylvania (PA)", "Rhode Island (RI)", "South Carolina (SC)", "South Dakota (SD)", "Tennessee (TN)", "Texas (TX)", "Utah (UT)", "Virginia (VA)", "Vermont (VT)", "Washington (WA)", "Wisconsin (WI)", "West Virginia (WV)", "Wyoming (WY)" ] } }, "matchMode": { "title": "Name matching", "enum": [ "contains", "exact", "starts" ], "type": "string", "description": "How the company name is matched. Contains finds every business whose name includes your text, exact returns only the registered legal name, starts returns names beginning with your text.", "default": "contains" }, "maxResultsPerState": { "title": "Maximum results per state", "minimum": 1, "maximum": 500, "type": "integer", "description": "Caps how many businesses are returned per company name in each state. Raise it for broad names that match many businesses.", "default": 25 }, "includeDetails": { "title": "Include full details", "type": "boolean", "description": "Adds officers and directors, the registered agent, principal and mailing addresses, and filing history where the state publishes them. Turn off for a faster, cheaper name and status check.", "default": true }, "includeLiens": { "title": "Include UCC lien filings", "type": "boolean", "description": "Attaches the UCC lien filings recorded against each business, with the secured party, collateral and filing dates, in the states that publish them. Needs full details switched on.", "default": true }, "marylandFullDetail": { "title": "Maryland: fetch full company details", "type": "boolean", "description": "Adds Maryland's formation date, state of formation, principal office, resident agent and good-standing flag. Maryland puts these behind a separate check, so unlike every other state this costs per company returned rather than per search, and makes the run slower. The cost is included in the per-result price, not billed separately. Off by default; every other state returns its full detail regardless.", "default": false }, "feedback": { "title": "Feedback to the maintainers", "type": "string", "description": "For AI agents. If a previous run returned wrong, missing or unexpected data, rerun once with the same input plus this text saying what went wrong and what you expected. The run records the report and exits before searching, so nothing is scraped and no results are charged." } } }, "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 } } } } } } } } } }