# NY UCC Lien Search — New York DOS Filing & Debtor Records (`keeganlabs/ny-ucc-lien-search`) Actor 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. - **URL**: https://apify.com/keeganlabs/ny-ucc-lien-search.md - **Developed by:** [Keegan Labs](https://apify.com/keeganlabs) (community) - **Categories:** Business, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 ucc filing results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## NY UCC Lien Search — New York DOS Filing & Debtor Records Search **New York State UCC financing statements and Federal Tax Liens** straight from the official NY Department of State index — the same records a paid "official" UCC search is built on — and get clean, structured JSON: filing number, filing and lapse dates, status, debtor name and address, secured party, and full filing history. New York moved its UCC search off the old `appext20.dos.ny.gov` system (now dead — the previously listed NY UCC actor on Apify is flagged *deprecated* for exactly that reason). This actor targets the **current** NY DOS portal (`ucc-efiling.dos.ny.gov`) and is actively maintained: it is the rebuilt, working replacement. ### Who this is for - **Lenders & credit teams** — check whether a borrower's assets are already encumbered before extending credit (equipment finance, factoring, MCA, ABL). - **KYC / onboarding & due-diligence** — surface existing liens and IRS tax liens against a counterparty in seconds instead of a manual portal session per name. - **Legal & UCC filing services** — monitor filings, verify lapse dates, pull filing history for continuations and terminations. - **Data & lead-gen teams** — find businesses with active secured lenders (e.g. everyone financed by a given lender, via the secured-party filter). ### What you get Every record is normalized — ISO dates, explicit nulls, stable field names: ```json { "lienNumber": "028823", "filingNumber": "028823", "serialNumber": "160252039", "lienSubtype": null, "debtorName": "ABC SEAMLESS OF CNY INC", "debtorAddress": "212 1/2 E 1ST ST, E SYRACUSE, NY, 13057 - 2908, USA", "debtorType": "Organization", "filingDate": "1986-01-24", "lapseDate": "2099-01-01", "status": "Active", "lienId": 3944017, "source": "ny-dos-ucc", "sourceUrl": "https://ucc-efiling.dos.ny.gov/", "searchType": "debtorOrganization", "query": "ABC", "retrievedAt": "2026-07-22T17:00:00.000Z" } ```` With `includeDetails: true` each record is enriched from the lien's detail page: ```json { "lienType": "Federal Tax Lien", "debtors": [ { "name": "A B C PAINTING", "address": "2440 SEDGWICK AVENUE, BRONX, NY, 10468 - 0000, USA", "type": "Organization", "organizationId": null, "organizationType": null, "organizationJurisdiction": null } ], "securedParties": [ { "name": "Internal Revenue Service", "address": "1500 Pennsylvania Avenue NW, Washington, DC, USA", "type": "Organization" } ], "filingHistory": [ { "filingNumber": "312731", "filingType": "Notice of Federal Tax Lien", "filingAction": "Notice of Federal Tax Lien", "filingStatus": null, "dateFiled": "1988-12-13" } ] } ``` ### Search options | Input | What it does | | --- | --- | | `searchType` | `debtorOrganization`, `debtorIndividual`, or `filingNumber` | | `debtorName` / `lastName`+`firstName` | The name to search | | `searchLogic` | `standard` (NYS standard debtor search), `startsWith`, `exactMatch`, `containsAllInOrder` | | `lienType` | All / UCC Lien / Federal Tax Lien | | `lienStatus` | All / Active / Released / Withdrawn / Purged / Lapsed | | `filingDateFrom/To`, `lapseDateFrom/To` | Date-range filters (YYYY-MM-DD) | | `securedPartyFilter` | Only output liens whose secured party contains this text | | `includeDetails` | Enrich every record with secured parties + filing history | | `maxResults` | Cap the number of records (default 100) | ### Freshness Results come **live from the NY DOS index at run time** — nothing cached, nothing pre-scraped. The index covers UCC Article 9 / Revised Article 9 financing statements and Notices of Federal Tax Liens. Note the portal's own disclaimer: web results are not a certified official search. ### Pricing Pay-per-event — you pay for what you get, no subscription: | Event | Price | | --- | --- | | Search session (actor start) | $0.01 | | UCC filing result (per record) | $0.004 | | Lien detail enrichment (per lien, optional) | $0.02 | **Why these numbers:** the live New Jersey UCC actor charges $2.00/1,000 filing results on a plain-HTTP portal; New York's portal requires a real browser session behind a Cloudflare challenge (residential proxy + browser compute per run), so the per-record price is 2× NJ's at $4.00/1,000. The live California UCC actor charges from $35.00/1,000 search sessions — a full NY search session here (start + 100 records) costs ~$0.41, and a detail-enriched lookup ($0.02) stays well under CA's per-session rate. A single manual paralegal lookup runs $15–75 at commercial UCC search shops; this actor does it for cents. ### Notes - A real browser (bundled) clears the portal's Cloudflare check automatically; use the default residential proxy setting for reliable runs. - The actor searches politely: one session, sequential pages, throttled requests. - `filingNumber` search returns that filing's record directly; secured-party discovery works via `securedPartyFilter` + detail enrichment (the NY portal does not expose a top-level secured-party search). # Actor input Schema ## `searchType` (type: `string`): 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). ## `debtorName` (type: `string`): Organization/business debtor name to search (required for searchType = debtorOrganization). Example: "ABC". ## `lastName` (type: `string`): Individual debtor last name (required for searchType = debtorIndividual). ## `firstName` (type: `string`): Individual debtor first name (optional). ## `middleName` (type: `string`): Individual debtor middle name (optional). ## `filingNumber` (type: `string`): Exact NY DOS lien/filing number (required for searchType = filingNumber). ## `searchLogic` (type: `string`): How the portal matches the debtor name. ## `lienType` (type: `string`): Restrict to UCC liens or Federal Tax Liens (the NY index contains both). ## `lienStatus` (type: `string`): Filter by lien status. ## `filingDateFrom` (type: `string`): Earliest filing date, YYYY-MM-DD (or M/D/YYYY). ## `filingDateTo` (type: `string`): Latest filing date, YYYY-MM-DD (or M/D/YYYY). ## `lapseDateFrom` (type: `string`): Earliest lapse date, YYYY-MM-DD (or M/D/YYYY). ## `lapseDateTo` (type: `string`): Latest lapse date, YYYY-MM-DD (or M/D/YYYY). ## `securedPartyFilter` (type: `string`): Only output liens whose secured-party name contains this text (case-insensitive). Forces detail lookups (charged as lien-detail events). ## `includeDetails` (type: `boolean`): Fetch each lien's detail page: secured parties, all debtors, lien type, and full filing history. Charged per detail (see pricing). ## `maxResults` (type: `integer`): Stop after this many records have been pushed. ## `proxyConfiguration` (type: `object`): Apify Proxy settings. Residential proxies are recommended — the portal sits behind a Cloudflare managed challenge. ## Actor input object example ```json { "searchType": "debtorOrganization", "debtorName": "ABC", "searchLogic": "standard", "lienType": "all", "lienStatus": "all", "includeDetails": false, "maxResults": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "debtorName": "ABC", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("keeganlabs/ny-ucc-lien-search").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "debtorName": "ABC", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("keeganlabs/ny-ucc-lien-search").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "debtorName": "ABC", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call keeganlabs/ny-ucc-lien-search --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=keeganlabs/ny-ucc-lien-search", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "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 } } } } } } } } } } ```