{
  "openapi": "3.0.1",
  "info": {
    "title": "Florida UCC Lien Search - Debtors & Secured Parties",
    "description": "Search Florida UCC-1 lien filings: every debtor and secured party with full address, filed/lapsed status, filing and expiration dates, the UCC-3 amendment chain (continuation, termination, assignment) and document images. Filter by state, city, ZIP, lender and dates. JSON, CSV, Excel.",
    "version": "0.1",
    "x-build-id": "VUxCaQVxbNaAlvdIz"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapers_lat~florida-ucc-liens-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapers_lat-florida-ucc-liens-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/scrapers_lat~florida-ucc-liens-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapers_lat-florida-ucc-liens-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/scrapers_lat~florida-ucc-liens-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapers_lat-florida-ucc-liens-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": {
          "searchMode": {
            "title": "Search mode",
            "enum": [
              "debtorName",
              "documentNumbers",
              "indexSweep"
            ],
            "type": "string",
            "description": "Debtor name: look up liens filed against a company or person. Document numbers: pull specific UCC filings you already know. Index sweep: walk the register's alphabetical debtor index from any position - the route to bulk coverage of all ~7.3 million indexed debtor names.",
            "default": "debtorName"
          },
          "debtorName": {
            "title": "Debtor name",
            "type": "string",
            "description": "Company or person the lien is filed against. Individuals are indexed LAST FIRST MIDDLE, e.g. \"GARCIA MARIA\"."
          },
          "debtorNames": {
            "title": "More debtor names",
            "type": "array",
            "description": "Search several debtors in one run. Combined with the single Debtor name field above.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "documentNumbers": {
            "title": "UCC document numbers",
            "type": "array",
            "description": "Exact UCC filing numbers, e.g. 202500210713. Used when Search mode is \"By UCC document number(s)\".",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "startRowNumber": {
            "title": "Sweep start position",
            "minimum": 1,
            "type": "integer",
            "description": "Where to start the index sweep. The run prints the next position when it finishes, so a follow-up run resumes exactly where this one stopped. Positions run 1 to about 7,300,000 for filed+lapsed, 1 to about 1,825,000 for filed only.",
            "default": 1
          },
          "debtorType": {
            "title": "Debtor type",
            "enum": [
              "any",
              "organization",
              "individual"
            ],
            "type": "string",
            "description": "Organisations only, individuals only, or both. \"Both\" walks the combined index and is the right choice for sweeps.",
            "default": "any"
          },
          "lienStatus": {
            "title": "Lien status",
            "enum": [
              "both",
              "filed",
              "lapsed"
            ],
            "type": "string",
            "description": "Filed = liens still on the record. Lapsed = liens past their expiration date. Both searches the full historic index.",
            "default": "both"
          },
          "nameMatch": {
            "title": "Name match",
            "enum": [
              "nearby",
              "exact"
            ],
            "type": "string",
            "description": "Nearby: seek to the name and keep reading forward through the index, which also returns close variants and misspellings. Exact: return only the filings whose indexed debtor name matches exactly. Exact is available for organisation searches.",
            "default": "nearby"
          },
          "maxRecords": {
            "title": "Max UCC filings",
            "minimum": 1,
            "type": "integer",
            "description": "How many filings to return. Each unique filing is charged once, no matter how many debtor names it is indexed under. Free Apify plans are capped at 10 per run.",
            "default": 10
          },
          "includeFilingHistory": {
            "title": "Include amendment history",
            "type": "boolean",
            "description": "Fetch the UCC-3 chain hanging off each filing: continuations, terminations, assignments and party changes, plus the flags derived from them. Needed to tell a live lien from a terminated one.",
            "default": true
          },
          "includeDocumentImageUrl": {
            "title": "Include document image link",
            "type": "boolean",
            "description": "Add a direct link to the scanned filing form, which carries the collateral description. Links are time-limited by the registry, so download them during the run.",
            "default": false
          },
          "debtorStates": {
            "title": "Debtor state",
            "type": "array",
            "description": "Keep only filings with a debtor in these states, e.g. FL, CA. Florida indexes out-of-state debtors too.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "debtorCityContains": {
            "title": "Debtor city contains",
            "type": "string",
            "description": "Keep only filings with a debtor whose city contains this text, e.g. MIAMI."
          },
          "debtorZipPrefixes": {
            "title": "Debtor ZIP starts with",
            "type": "array",
            "description": "Keep only filings with a debtor ZIP starting with one of these, e.g. 331 for Miami. Targets a metro without naming every city.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "debtorNameContains": {
            "title": "Debtor name contains",
            "type": "string",
            "description": "Keep only filings where some debtor's name contains this text. Useful on a sweep to pull one industry out of the index."
          },
          "securedPartyContains": {
            "title": "Secured party (lender) contains",
            "type": "string",
            "description": "Keep only filings whose secured party name contains this text, e.g. a bank or equipment lessor. The registry has no lender search of its own - this filter reads the lender off every filing."
          },
          "documentTypes": {
            "title": "Document type",
            "type": "array",
            "description": "Keep only these form types, e.g. UCC1, UCC3.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "filedFrom": {
            "title": "Filed from",
            "type": "string",
            "description": "Keep only filings recorded on or after this date (YYYY-MM-DD)."
          },
          "filedTo": {
            "title": "Filed to",
            "type": "string",
            "description": "Keep only filings recorded on or before this date (YYYY-MM-DD)."
          },
          "expiresFrom": {
            "title": "Expires from",
            "type": "string",
            "description": "Keep only filings expiring on or after this date (YYYY-MM-DD). Combined with Expires to, this isolates liens coming up for lapse or continuation."
          },
          "expiresTo": {
            "title": "Expires to",
            "type": "string",
            "description": "Keep only filings expiring on or before this date (YYYY-MM-DD)."
          },
          "minDebtors": {
            "title": "Minimum debtors on the filing",
            "minimum": 1,
            "type": "integer",
            "description": "Keep only filings naming at least this many debtors. Filings with many debtors typically map a whole group of related companies to one address."
          },
          "onlyWithEmail": {
            "title": "Only filings with an email",
            "type": "boolean",
            "description": "Keep only filings where a contact email appears on a debtor or secured party record.",
            "default": false
          },
          "excludeTerminated": {
            "title": "Exclude terminated liens",
            "type": "boolean",
            "description": "Drop filings that a later UCC-3 terminated. Reads the amendment chain, so it turns amendment history on.",
            "default": false
          },
          "onlyTransmittingUtility": {
            "title": "Only transmitting utilities",
            "type": "boolean",
            "description": "Keep only transmitting-utility filings (railroads, pipelines, telecom and power utilities), which never lapse on the normal five-year clock.",
            "default": false
          },
          "maxConcurrency": {
            "title": "Concurrency",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "How many filings to fetch in parallel. Lower it if the registry starts refusing requests.",
            "default": 5
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Optional. The registry is reachable without a proxy; add one only if you are running at high volume.",
            "default": {
              "useApifyProxy": 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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}