{
  "openapi": "3.0.1",
  "info": {
    "title": "Cumberland County ME Liens: UCC, Tax & Municipal",
    "description": "Search Cumberland County, Maine recorded liens by debtor or lender. Get UCC filings, federal tax liens, municipal liens, labor liens and releases with parties, dates, book/page and document status in clean JSON. $0.015 per record.",
    "version": "0.1",
    "x-build-id": "LjIZfvE0PvKSQbpZb"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/lienintel~cumberland-county-me-lien-filings/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-lienintel-cumberland-county-me-lien-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/lienintel~cumberland-county-me-lien-filings/runs": {
      "post": {
        "operationId": "runs-sync-lienintel-cumberland-county-me-lien-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/lienintel~cumberland-county-me-lien-filings/run-sync": {
      "post": {
        "operationId": "run-sync-lienintel-cumberland-county-me-lien-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": {
          "debtorNames": {
            "title": "Debtor, owner or employer names",
            "type": "array",
            "description": "Names to search on the debtor, owner, employer or grantor side, up to 20. Partial names are supported, for example SMITH, JONES or SMITHFIELD. Each name is searched separately and results are deduplicated.",
            "items": {
              "type": "string"
            }
          },
          "securedPartyNames": {
            "title": "Lender, lien claimant or creditor names",
            "type": "array",
            "description": "Names to search on the secured-party, lien-claimant, creditor or release side, up to 20. For example GOODLEAP, CONCERT FINANCE, INTERNAL REVENUE or a town or contractor name. Each name is searched separately.",
            "items": {
              "type": "string"
            }
          },
          "lienTypes": {
            "title": "Lien categories",
            "type": "array",
            "description": "Categories to include. Allowed values: ucc, tax_lien, municipal_lien, labor_lien, other_lien. Leave empty for all categories.",
            "default": [
              "ucc",
              "tax_lien",
              "municipal_lien",
              "labor_lien",
              "other_lien"
            ],
            "items": {
              "type": "string"
            }
          },
          "includeReleases": {
            "title": "Include releases, discharges and terminations",
            "type": "boolean",
            "description": "Include UCC terminations and partial releases, federal tax-lien discharges and partial releases, municipal lien discharges and releases, and Maine DOL lien discharges. Turn off to return only new liens and active filings.",
            "default": true
          },
          "town": {
            "title": "Town",
            "type": "string",
            "description": "Optional Cumberland County town to narrow the search, for example PORTLAND, BRUNSWICK, SCARBOROUGH, GORHAM or WINDHAM. Leave empty for all towns."
          },
          "matchType": {
            "title": "Name match type",
            "enum": [
              "contains",
              "soundex",
              "near"
            ],
            "type": "string",
            "description": "How names are matched: contains (default), soundex or near.",
            "default": "contains"
          },
          "dateFrom": {
            "title": "Recorded from",
            "type": "string",
            "description": "Earliest recorded date in YYYY-MM-DD format. Leave empty for the last 365 days. Long ranges are split automatically."
          },
          "dateTo": {
            "title": "Recorded to",
            "type": "string",
            "description": "Latest recorded date in YYYY-MM-DD format. Leave empty for today."
          },
          "maxFilings": {
            "title": "Maximum records",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "Maximum number of unique lien or UCC records to return and charge. Free Apify users receive up to 10 results per run.",
            "default": 25
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}