{ "openapi": "3.0.1", "info": { "title": "Kentucky UCC Filings Search: Debtors, Lenders & Liens", "description": "Search Kentucky UCC filings by debtor name or filing number. Get filing dates, lapse dates, status, debtors, secured parties, addresses, collateral and document links. Clean JSON, filters and pay per result.", "version": "0.1", "x-build-id": "AV7ZHBwevE9iEwaEw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lienintel~kentucky-ucc-filings-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lienintel-kentucky-ucc-filings-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/lienintel~kentucky-ucc-filings-search/runs": { "post": { "operationId": "runs-sync-lienintel-kentucky-ucc-filings-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/lienintel~kentucky-ucc-filings-search/run-sync": { "post": { "operationId": "run-sync-lienintel-kentucky-ucc-filings-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": { "debtorNames": { "title": "Organization debtor names", "type": "array", "description": "Organization or trade-name debtors to search, up to 20. Kentucky applies its standard and non-standard name logic, so a prefix such as SMITH also returns related names.", "items": { "type": "string" } }, "individualDebtorNames": { "title": "Individual debtor names", "type": "array", "description": "Individual people to search as Last, First Middle Suffix, up to 20. A bare last name also works. Example: SMITH, KEVIN.", "items": { "type": "string" } }, "filingNumbers": { "title": "Kentucky filing numbers", "type": "array", "description": "Exact file numbers in YYYY-NNNNNNN-CC form, up to 20. Example: 2026-3437598-59. Digits only is also accepted.", "items": { "type": "string" } }, "filingDateFrom": { "title": "Filing date from", "type": "string", "description": "Only return filings on or after this date (YYYY-MM-DD). Leave empty for no lower bound." }, "filingDateTo": { "title": "Filing date to", "type": "string", "description": "Only return filings on or before this date (YYYY-MM-DD). Leave empty for no upper bound." }, "lapseDateFrom": { "title": "Lapse date from", "type": "string", "description": "Only return filings whose lapse date is on or after this date (YYYY-MM-DD)." }, "lapseDateTo": { "title": "Lapse date to", "type": "string", "description": "Only return filings whose lapse date is on or before this date (YYYY-MM-DD)." }, "status": { "title": "Lien status", "enum": [ "any", "active", "lapsed", "terminated" ], "type": "string", "description": "Filter by normalized lien status. Active means no termination and a lapse date in the future. Lapsed means the lapse date has passed. Terminated means a termination action is present.", "default": "any" }, "debtorType": { "title": "Debtor type", "enum": [ "any", "organization", "individual" ], "type": "string", "description": "Keep organizations, individuals, or both. The type is inferred from the published debtor name.", "default": "any" }, "securedPartyNames": { "title": "Secured party contains", "type": "array", "description": "Only keep filings with a secured party, lender or funder whose name contains one of these terms. Useful for watching a bank, equipment finance company or MCA funder.", "items": { "type": "string" } }, "debtorCity": { "title": "Debtor city contains", "type": "string", "description": "Only keep filings whose primary debtor city contains this text, case-insensitive." }, "debtorState": { "title": "Debtor state", "enum": [ "any", "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY" ], "type": "string", "description": "Only keep filings whose primary debtor address is in this state.", "default": "any" }, "collateralKeyword": { "title": "Collateral contains", "type": "string", "description": "Only keep filings whose collateral description contains this text, case-insensitive. Example: track loader, receivables, inventory." }, "includeAmendments": { "title": "Include filings with amendments", "type": "boolean", "description": "Include filing chains that contain UCC-3 amendments, assignments or corrections. Turn off to keep only pure initial statements and continuations.", "default": true }, "includeContinuations": { "title": "Include filings with continuations", "type": "boolean", "description": "Include filing chains that contain a continuation action.", "default": true }, "includeTerminated": { "title": "Include terminated filings", "type": "boolean", "description": "Include filing chains with a termination action. Turn off for active and lapsed liens only.", "default": true }, "includeLapsed": { "title": "Include lapsed filings", "type": "boolean", "description": "Include filing chains whose lapse date has passed. Turn off for active and terminated liens only.", "default": true }, "includeStandardResults": { "title": "Include standard name matches", "type": "boolean", "description": "Include the state's standard-search matches. These are the closest name matches and are ranked first.", "default": true }, "includeNonStandardResults": { "title": "Include non-standard name matches", "type": "boolean", "description": "Include the broader non-standard name matches. Turn off for exact-style results only. The state returns at most 401 non-standard rows per name.", "default": true }, "maxFilings": { "title": "Max filings", "minimum": 1, "maximum": 400, "type": "integer", "description": "Maximum number of UCC filing records to return. Free users are capped at 10. The source returns at most 401 rows per name search." } } }, "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 } } } } } } } } } }