{ "openapi": "3.0.1", "info": { "title": "NY UCC Lien Search — New York DOS Filing & Debtor Records", "description": "Search New York State UCC financing statements and Federal Tax Liens by debtor name or filing number on the official NY Department of State portal. Filing number, dates, status, debtor, secured party, filing history.", "version": "0.1", "x-build-id": "F9q9eO5p7GbVrwiSn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/keeganlabs~ny-ucc-lien-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-keeganlabs-ny-ucc-lien-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/keeganlabs~ny-ucc-lien-search/runs": { "post": { "operationId": "runs-sync-keeganlabs-ny-ucc-lien-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/keeganlabs~ny-ucc-lien-search/run-sync": { "post": { "operationId": "run-sync-keeganlabs-ny-ucc-lien-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", "required": [ "searchType" ], "properties": { "searchType": { "title": "Search type", "enum": [ "debtorOrganization", "debtorIndividual", "filingNumber" ], "type": "string", "description": "What to search by. The NY portal supports debtor-name and filing-number search; secured-party matching is available via the `securedPartyFilter` option (applied to lien details).", "default": "debtorOrganization" }, "debtorName": { "title": "Debtor organization name", "type": "string", "description": "Organization/business debtor name to search (required for searchType = debtorOrganization). Example: \"ABC\"." }, "lastName": { "title": "Debtor last name", "type": "string", "description": "Individual debtor last name (required for searchType = debtorIndividual)." }, "firstName": { "title": "Debtor first name", "type": "string", "description": "Individual debtor first name (optional)." }, "middleName": { "title": "Debtor middle name", "type": "string", "description": "Individual debtor middle name (optional)." }, "filingNumber": { "title": "Filing (lien) number", "type": "string", "description": "Exact NY DOS lien/filing number (required for searchType = filingNumber)." }, "searchLogic": { "title": "Name match logic", "enum": [ "standard", "startsWith", "exactMatch", "containsAllInOrder" ], "type": "string", "description": "How the portal matches the debtor name.", "default": "standard" }, "lienType": { "title": "Lien type", "enum": [ "all", "ucc", "federalTaxLien" ], "type": "string", "description": "Restrict to UCC liens or Federal Tax Liens (the NY index contains both).", "default": "all" }, "lienStatus": { "title": "Lien status", "enum": [ "all", "active", "released", "withdrawn", "purged", "lapsed" ], "type": "string", "description": "Filter by lien status.", "default": "all" }, "filingDateFrom": { "title": "Filing date from", "type": "string", "description": "Earliest filing date, YYYY-MM-DD (or M/D/YYYY)." }, "filingDateTo": { "title": "Filing date to", "type": "string", "description": "Latest filing date, YYYY-MM-DD (or M/D/YYYY)." }, "lapseDateFrom": { "title": "Lapse date from", "type": "string", "description": "Earliest lapse date, YYYY-MM-DD (or M/D/YYYY)." }, "lapseDateTo": { "title": "Lapse date to", "type": "string", "description": "Latest lapse date, YYYY-MM-DD (or M/D/YYYY)." }, "securedPartyFilter": { "title": "Secured party contains", "type": "string", "description": "Only output liens whose secured-party name contains this text (case-insensitive). Forces detail lookups (charged as lien-detail events)." }, "includeDetails": { "title": "Include lien details", "type": "boolean", "description": "Fetch each lien's detail page: secured parties, all debtors, lien type, and full filing history. Charged per detail (see pricing).", "default": false }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many records have been pushed.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy settings. Residential proxies are recommended — the portal sits behind a Cloudflare managed challenge.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }