{
  "openapi": "3.0.1",
  "info": {
    "title": "UCC Filings Scraper: New Liens, Borrowers & Lenders $3.80/1K",
    "description": "New UCC filings and liens about to lapse from Secretary of State records in Connecticut, Colorado and Oregon: the borrowing business, its address, the lender, filing and lapse dates and Colorado collateral. Search by date, lender, borrower or collateral. $3.80 per 1,000 filings.",
    "version": "1.0",
    "x-build-id": "jjdshiba6Jq4858F4"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/bulkleads~ucc-filings-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-bulkleads-ucc-filings-scraper",
        "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/bulkleads~ucc-filings-scraper/runs": {
      "post": {
        "operationId": "runs-sync-bulkleads-ucc-filings-scraper",
        "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/bulkleads~ucc-filings-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-bulkleads-ucc-filings-scraper",
        "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": "Secretary of State records to search: CT (Connecticut, updated nightly), CO (Colorado, daily) and OR (Oregon, the previous month). All three by default.",
            "items": {
              "type": "string",
              "enum": [
                "CT",
                "CO",
                "OR"
              ],
              "enumTitles": [
                "Connecticut",
                "Colorado",
                "Oregon"
              ]
            },
            "default": [
              "CT",
              "CO",
              "OR"
            ]
          },
          "filedFrom": {
            "title": "Filed on or after",
            "type": "string",
            "description": "A date like 2026-10-01. Empty: the last 30 days."
          },
          "filedTo": {
            "title": "Filed on or before",
            "type": "string",
            "description": "A date like 2026-11-15 (optional)."
          },
          "lapsingWithinDays": {
            "title": "Lapsing within days (instead of new filings)",
            "minimum": 1,
            "maximum": 730,
            "type": "integer",
            "description": "Filings that lapse within this many days and were not continued: borrowers whose loan or lease term is ending. Leave empty for new filings."
          },
          "lender": {
            "title": "Lender (secured party) name contains",
            "type": "string",
            "description": "e.g. a competitor's name, to see who they just funded (optional)."
          },
          "borrowerName": {
            "title": "Borrower name contains",
            "type": "string",
            "description": "A word in the borrowing business's name, e.g. Trucking or Dental (optional)."
          },
          "borrowerStates": {
            "title": "Borrower states",
            "type": "array",
            "description": "Only borrowers with a mailing address in these states, as two-letter codes, e.g. CT, NY (optional).",
            "items": {
              "type": "string"
            }
          },
          "collateralKeywords": {
            "title": "Collateral keywords (Colorado)",
            "type": "array",
            "description": "Only filings whose collateral mentions any of these, e.g. equipment, vehicles, accounts receivable. Colorado publishes collateral; the other states do not.",
            "items": {
              "type": "string"
            }
          },
          "borrowerNames": {
            "title": "Borrower names (look up companies instead)",
            "type": "array",
            "description": "Company names, one per line: the active UCC filings on record for each, in these states, whatever the dates above. Other actors' Add UCC filings add-on uses this.",
            "items": {
              "type": "string"
            }
          },
          "maxFilingsPerBorrower": {
            "title": "Max filings per borrower name",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Max filings per borrower name.",
            "default": 25
          },
          "exactBorrowerNames": {
            "title": "Only the companies named exactly",
            "type": "boolean",
            "description": "On: a borrower name finds only that company (the same name apart from LLC, Inc and punctuation, or a dba of it), not other names containing its words. Off: every name containing the words.",
            "default": false
          },
          "borrowerType": {
            "title": "Borrowers",
            "enum": [
              "business",
              "individual",
              "all"
            ],
            "type": "string",
            "description": "Businesses only by default.",
            "default": "business"
          },
          "includeOtherLiens": {
            "title": "Also include tax, judgment and other liens",
            "type": "boolean",
            "description": "Off: UCC financing statements only.",
            "default": false
          },
          "maxFilings": {
            "title": "Max filings",
            "minimum": 1,
            "maximum": 20000,
            "type": "integer",
            "description": "Stop after this many filings (up to 20,000 a run).",
            "default": 500
          },
          "addDecisionMakers": {
            "title": "Add decision-makers at each company",
            "type": "boolean",
            "description": "Also adds people with a work email at each company website found, from LinkedIn Company Employees. Charged by it at its own price, per person added.",
            "default": false
          },
          "decisionMakerTitles": {
            "title": "Decision-maker titles",
            "type": "array",
            "description": "Only people with these titles, e.g. CEO, Founder, Head of Marketing.",
            "items": {
              "type": "string"
            }
          },
          "decisionMakersPerCompany": {
            "title": "Decision-makers per company",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Decision-makers per company.",
            "default": 3
          },
          "checkDecisionMakerEmails": {
            "title": "Check decision-makers' emails not checked yet",
            "type": "boolean",
            "description": "Their emails not checked in the last 90 days are checked first by Bulk Email Verifier (charged by it at its own price).",
            "default": false
          },
          "addWebsiteContacts": {
            "title": "Add emails and phones from each website",
            "type": "boolean",
            "description": "Also reads each company website found (contact, team and about pages) for emails, phones and social profiles, with Website Contact Scraper. Charged by it at its own price, per page read.",
            "default": false
          },
          "websiteContactPages": {
            "title": "Pages read per website",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Pages read per website.",
            "default": 5
          },
          "addCompanyDetails": {
            "title": "Add company details",
            "type": "boolean",
            "description": "Also adds size, revenue, funding, industry, location and tech for each company website found, from LinkedIn Company Details. Charged by it at its own price, per company found.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}