{ "openapi": "3.0.1", "info": { "title": "UCC Filing Monitor — Debtor & Lender Leads", "description": "Monitor new UCC lien filings from official state SOS open data (CT, CO). Daily new-filing delta, debtor watchlist hits, and 5-year lapse/continuation deadline alerts. Debtor and secured party details included. No captcha, no API key.", "version": "1.2", "x-build-id": "8pHThghatbPUKuAjm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/intelscrape~ucc-filing-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-intelscrape-ucc-filing-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/intelscrape~ucc-filing-monitor/runs": { "post": { "operationId": "runs-sync-intelscrape-ucc-filing-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/intelscrape~ucc-filing-monitor/run-sync": { "post": { "operationId": "run-sync-intelscrape-ucc-filing-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": { "mode": { "title": "Mode", "enum": [ "new-filings", "watchlist", "lapse-alerts" ], "type": "string", "description": "new-filings = only liens filed since your last run (the daily feed). watchlist = only filings against businesses you are tracking. lapse-alerts = active liens entering their 5-year continuation window.", "default": "new-filings" }, "states": { "title": "States", "type": "array", "description": "Which state registries to monitor. Both publish official UCC data daily.", "items": { "type": "string", "enum": [ "CT", "CO" ], "enumTitles": [ "Connecticut", "Colorado" ] }, "default": [ "CT", "CO" ] }, "trackerId": { "title": "Tracker ID", "type": "string", "description": "Names this watch's memory. Runs sharing a Tracker ID share one cursor, so each run returns only what the previous one did not. Use separate IDs for separate watches (e.g. 'equipment-leads' vs 'portfolio-monitoring').", "default": "default" }, "watchlist": { "title": "Debtor watchlist", "type": "array", "description": "Business names to watch for (partial match, case-insensitive). Used in watchlist mode — get alerted when a competing secured party files against a business you have lent to.", "items": { "type": "string" } }, "lapseWithinDays": { "title": "Lapse window (days)", "minimum": 1, "maximum": 1825, "type": "integer", "description": "For lapse-alerts mode: how far ahead to look for liens approaching lapse. A UCC-1 dies 5 years after filing unless continued, and the continuation window opens 6 months (180 days) before.", "default": 180 }, "filingTypes": { "title": "Filing types", "type": "array", "description": "Optional filter, partial match (e.g. 'ORIG FIN STMT' for original filings only, 'AMENDMENT', 'RELEASE'). Leave empty for all.", "items": { "type": "string" } }, "debtorState": { "title": "Debtor state filter", "type": "string", "description": "Optional: only return filings whose DEBTOR address is in this state (e.g. 'CT'). Useful when you only sell into one territory." }, "maxResults": { "title": "Max filings per run", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum FILINGS this run may deliver and bill. One filing = one billable row, even when the source lists several debtors for it. A default weekday delta across CT+CO is roughly 200-500 filings; a first run with a 7-day lookback can reach this ceiling, so lower it if you want a cheaper first run.", "default": 500 }, "lookbackDaysOnFirstRun": { "title": "First-run lookback (days)", "minimum": 1, "maximum": 90, "type": "integer", "description": "On the very first run there is no cursor, so this decides how much history seeds the baseline. 7 days across CT+CO is several hundred filings and is billed like any other delivery - set it to 1 for a cheap first run. Later runs ignore this.", "default": 7 }, "resetTracker": { "title": "Reset tracker", "type": "boolean", "description": "Wipe this Tracker ID's memory and rebuild the baseline. Turn on only if you want to re-pull history you already received.", "default": false }, "requirePartyInfo": { "title": "Require debtor or secured party", "type": "boolean", "description": "Filter out purely administrative filings that carry no debtor and no secured party in the source data (e.g. CT 'OFFICE CORRECT' rows). These cannot tell you who filed or who is lapsing. Turn off to receive them anyway.", "default": true }, "includeFilingsAnalytics": { "title": "Include filings analytics summary", "type": "boolean", "description": "When true (default ON), push one free ucc-filing-batch-summary row with state/type/change/debtor breakdowns and SoftCTA. No extra PPE charge.", "default": true }, "demoMode": { "title": "Demo mode", "type": "boolean", "description": "Push synthetic UCC filing fixtures with SoftCTA (no portal I/O).", "default": false } } }, "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 } } } } } } } } } }