{ "openapi": "3.0.1", "info": { "title": "UCC Filings & Lien Search — Tax Liens, CT CO NY OR", "description": "New UCC financing statements and liens (Connecticut, Colorado, Oregon) and New York State tax warrants against companies with the amount owed, or look a company's liens up by name: debtor, secured party, collateral, dates. Only new since last run. No login.", "version": "0.1", "x-build-id": "pMoj5WeeJrIENIMgN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/northbell~ucc-filings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-northbell-ucc-filings", "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/northbell~ucc-filings/runs": { "post": { "operationId": "runs-sync-northbell-ucc-filings", "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/northbell~ucc-filings/run-sync": { "post": { "operationId": "run-sync-northbell-ucc-filings", "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": { "states": { "title": "States", "type": "array", "description": "The state records to read. Leave empty for all four. Connecticut, Colorado and Oregon: Secretary of State UCC filings and liens (Connecticut the next day, Colorado 2 to 3 days late, Oregon once a month: the previous month's filings appear at the start of the month, so set Filed within to 62 days to see them). New York: tax warrants the Department of Taxation and Finance filed against companies, with the amount, posted in a weekly batch.", "items": { "type": "string", "enum": [ "CT", "CO", "OR", "NY" ], "enumTitles": [ "Connecticut (UCC and liens)", "Colorado (UCC and liens)", "Oregon (UCC and liens, monthly)", "New York (state tax warrants)" ] } }, "filedWithinDays": { "title": "Filed within (days)", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Filings accepted by the state at most this many days ago (up to 3650, ten years). To look a company up, put its name in Debtor name contains and set this to 3650.", "default": 7 }, "kinds": { "title": "Kinds of filing", "type": "array", "description": "Leave empty for every kind. Pick UCC financing statements for companies that just took secured financing, or the tax liens for companies the state or the IRS put a lien on. New York has state tax warrants only.", "items": { "type": "string", "enum": [ "financing", "federal-tax", "state-tax", "municipal", "statutory", "judgment", "labor", "farm-products", "other" ], "enumTitles": [ "UCC financing statements (secured loans, leases, equipment finance)", "Federal tax liens (IRS)", "State tax liens", "Municipal liens (CT)", "Other statutory liens", "Judgment liens (CT)", "Labor liens (CT)", "Farm products (EFS, CO)", "Other" ] } }, "actions": { "title": "Which filings", "type": "array", "description": "Leave empty for new filings only. Add terminations and releases to see liens that ended (for New York, warrants paid in full or vacated).", "items": { "type": "string", "enum": [ "initial", "amendment", "continuation", "termination", "release", "correction" ], "enumTitles": [ "New filings (initial)", "Amendments", "Continuations (extended 5 more years)", "Terminations (the lien was lifted, for example a loan paid off)", "Releases of tax and other liens", "Corrections" ] } }, "debtorContains": { "title": "Debtor name contains", "type": "array", "description": "Keep only filings where a debtor company's name contains one of these words (e.g. `trucking`, `dental`, or a company name such as `Example Tools`). The words are sent to the state's own search, so a company name with Filed within 3650 days looks up its liens over ten years in seconds. Leave empty for all.", "items": { "type": "string" } }, "securedPartyContains": { "title": "Secured party contains", "type": "array", "description": "Keep only filings where a secured party (the lender, lessor or lien holder) contains one of these words (e.g. `bank`, `capital`, `funding`, `Internal Revenue`). Leave empty for all.", "items": { "type": "string" } }, "legalEntitiesOnly": { "title": "Companies only (legal entities)", "type": "boolean", "description": "Keep only debtors whose name shows a legal entity (LLC, Inc, Corp, LP, LLP, PC, Ltd, Co., Trust, Bank…). The states' company-name field also holds sole proprietors' trade names and, now and then, an owner's own name (about 1 in 8 debtor names); turn this off to include trade names. New York always returns companies only: its warrant list mixes in personal income tax warrants, which are never read.", "default": true }, "output": { "title": "Output", "enum": [ "all", "new" ], "type": "string", "description": "With \"only new\", a scheduled run returns just the filings the state published after your last run with the same settings (each state adds its filings in one batch a day; New York once a week); nothing else is read or charged. If a run stops at Max filings per state, the rest of that batch is not returned later: set the maximum high enough for a day.", "default": "all" }, "maxItemsPerState": { "title": "Max filings per state", "minimum": 1, "type": "integer", "description": "Stop after this many filings from each state (newest first).", "default": 500 } } }, "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 } } } } } } } } } }