{ "openapi": "3.0.1", "info": { "title": "Iowa Mechanics Lien Filings: Owners, Contractors & Liens", "description": "Search Iowa mechanics lien postings by owner, contractor, address, county, date or MNLR number. Get property, parcel, claimant, posting date, document type and status. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "FDw07rwZ23s9H9lhY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lienintel~iowa-mechanics-lien-filings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lienintel-iowa-mechanics-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~iowa-mechanics-lien-filings/runs": { "post": { "operationId": "runs-sync-lienintel-iowa-mechanics-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~iowa-mechanics-lien-filings/run-sync": { "post": { "operationId": "run-sync-lienintel-iowa-mechanics-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": { "searchMode": { "title": "Search mode", "enum": [ "new_filings", "owner", "contractor", "address", "legal_description", "mlnr_number" ], "type": "string", "description": "Choose the field to search. New filings scans the registry by county and posting date. Owner, contractor, address, legal description and MNLR number search the public index directly.", "default": "new_filings" }, "ownerNames": { "title": "Property owner names", "type": "array", "description": "Owner names to search, up to 20. Example: Smith Trust. Used only in owner mode.", "items": { "type": "string" } }, "contractorNames": { "title": "Contractor or claimant names", "type": "array", "description": "General contractor, subcontractor or claimant names to search, up to 20. Example: Home Pride Contractors. Used only in contractor mode.", "items": { "type": "string" } }, "addresses": { "title": "Property addresses", "type": "array", "description": "Street addresses to search, up to 20. Example: 22538 Tammy Cir. Add a city or ZIP to narrow the result. Used only in address mode.", "items": { "type": "string" } }, "legalDescriptions": { "title": "Legal descriptions", "type": "array", "description": "Legal description text to search, up to 20. Example: Pheasant Hills. Used only in legal description mode.", "items": { "type": "string" } }, "mlnrNumbers": { "title": "MNLR numbers", "type": "array", "description": "Exact MNLR numbers to look up, up to 50. Example: 062437-0. Used only in MNLR number mode.", "items": { "type": "string" } }, "city": { "title": "City", "type": "string", "description": "Optional city filter for owner, contractor, address and legal description searches. Example: Des Moines." }, "zip": { "title": "ZIP code", "type": "string", "description": "Optional ZIP code filter for address searches. Example: 50312." }, "counties": { "title": "Counties", "type": "array", "description": "Iowa counties to scan in new filing mode, up to 99. Use a name such as Polk or a list such as Polk, Linn, Scott. Leave empty and keep statewide enabled to scan all counties. In name, address and legal modes a county list narrows the delivered records.", "items": { "type": "string" } }, "statewide": { "title": "Statewide scan", "type": "boolean", "description": "When no specific county is supplied in new filing mode, scan all 99 counties. Turn off to require an explicit county list.", "default": true }, "filingDateFrom": { "title": "Posting date from", "type": "string", "description": "Earliest posting date in YYYY-MM-DD. Leave empty to use the last 7 days in new filing mode. In name modes the date window filters delivered records." }, "filingDateTo": { "title": "Posting date to", "type": "string", "description": "Latest posting date in YYYY-MM-DD. Leave empty to use today in new filing mode." }, "documentType": { "title": "Document type", "enum": [ "any", "commencement_of_work", "preliminary_notice", "mechanics_lien", "owner_notice", "withdrawal", "final_lien_waiver", "satisfaction_of_lien", "notice_of_completion", "other" ], "type": "string", "description": "Keep one posting type, or all types. The registry publishes commencement of work, preliminary notice, mechanic's lien, owner notice, withdrawal, final lien waiver, satisfaction and other postings.", "default": "any" }, "status": { "title": "Posting status", "enum": [ "any", "active", "inactive", "withdrawn" ], "type": "string", "description": "Keep active postings, inactive postings, withdrawn postings, or all statuses.", "default": "any" }, "includeInactive": { "title": "Include inactive postings", "type": "boolean", "description": "Include postings the registry marks inactive. Turn off to ask the source for active postings only.", "default": true }, "matchType": { "title": "Legal description match", "enum": [ "near", "exact" ], "type": "string", "description": "Near match returns legal descriptions that contain the search text. Exact match returns only an exact legal description.", "default": "near" }, "includeDetails": { "title": "Fetch property details", "type": "boolean", "description": "Fetch the public property page for each delivered posting to add the street address, county, legal description, tax parcel, property owner and full posting history. Turn off for a faster, leaner run.", "default": true }, "sortBy": { "title": "Sort order", "enum": [ "newest", "oldest" ], "type": "string", "description": "Newest first or oldest first by posting date.", "default": "newest" }, "maxFilings": { "title": "Maximum filings", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum posting records to deliver, from 1 to 1000. Free users are capped at 10 delivered records.", "default": 50 } } }, "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 } } } } } } } } } }