{ "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": "7w0ZfAbFTWZEcjZ66" }, "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. Say what you needed and did not get: a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. Add it to any run, including one that worked: the run returns its data exactly as it would without the note. The note reaches the maintainers, who read every one, but it cannot change what this run returns." } } }, "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 } } } } } } } } } }