{ "openapi": "3.0.1", "info": { "title": "UCC Lien Monitor — NY, FL, CO New Filings, No Login", "description": "Watch debtors (and secured parties in CO) across New York, Florida and Colorado UCC records and get only NEW lien filings and status changes since the last run: filing number, type, dates, lapse, secured parties. Daily schedule. No login. MCP-ready. $20 per 1,000 alerts.", "version": "1.0", "x-build-id": "I57Z30hgcw4eFVgHj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/chimerical_quicklime~ucc-lien-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-chimerical_quicklime-ucc-lien-monitor", "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/chimerical_quicklime~ucc-lien-monitor/runs": { "post": { "operationId": "runs-sync-chimerical_quicklime-ucc-lien-monitor", "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/chimerical_quicklime~ucc-lien-monitor/run-sync": { "post": { "operationId": "run-sync-chimerical_quicklime-ucc-lien-monitor", "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": "Debtor names to watch", "type": "array", "description": "Organization debtor names. NY and FL match every debtor whose name starts with the text (VERIZON finds VERIZON WIRELESS); CO applies its standard search logic (the normalized legal name, so use the full name). One row is emitted per NEW filing against each name.", "default": [ "VERIZON", "AMAZON", "CARNIVAL" ], "items": { "type": "string" } }, "securedPartyNames": { "title": "Secured party names to watch", "type": "array", "description": "Emit new filings FILED BY these lenders/lessors (competitor or portfolio tracking). Only Colorado offers a secured-party search; NY and FL skip these watches with a log line.", "default": [], "items": { "type": "string" } }, "states": { "title": "States", "type": "array", "description": "Which registries to query: NY (Department of State), FL (floridaucc.com), CO (Secretary of State). Others are ignored with a warning.", "default": [ "NY", "FL" ], "items": { "type": "string" } }, "lookbackDays": { "title": "Lookback window (days)", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Only filings dated within this many days count as new. Older filings the monitor has not seen yet are recorded silently so they never surface later. For a daily schedule 7-30 days is plenty; the seen-state prevents duplicates.", "default": 30 }, "maxNewPerWatch": { "title": "Max new filings per watch and state", "minimum": 1, "maximum": 500, "type": "integer", "description": "Stop after emitting this many changes for one name in one state. Filings beyond the cap stay unseen and come out on the next run.", "default": 5 }, "includeDetails": { "title": "Fetch filing details", "type": "boolean", "description": "Open each new filing's detail record to add secured parties, lien type and addresses (NY, FL). Florida rows carry no filing date, so FL details are always fetched. Colorado's list already includes the secured party.", "default": true }, "firstRunMode": { "title": "First run mode", "enum": [ "emitAll", "baseline" ], "type": "string", "description": "What to do when this monitor ID has no saved state yet. emitAll: emit every filing inside the lookback window (one-off pull or first test). baseline: silently record everything currently on file and emit nothing, so the next scheduled run reports only what is new since.", "default": "emitAll" }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Optional. After each run a JSON summary {monitorId, runAt, newFilings, statusChanges, filings[first 50]} is POSTed here (Slack/Zapier/Make/your API).", "default": "" }, "monitorId": { "title": "Monitor ID", "type": "string", "description": "Name of this watchlist. Each ID keeps its own seen-state in a key-value store named ucc-monitor-, so several portfolios can run side by side.", "default": "default" }, "maxItems": { "title": "Max records per run", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Overall cap on emitted records per run. Changes beyond it stay unseen and come out on the next run.", "default": 10 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "The NY and CO portals sit behind Cloudflare and reject datacenter IPs, so keep US residential proxies for those states. Florida's API needs no proxy.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }