{ "openapi": "3.0.1", "info": { "title": "Minnesota Contractor License Lookup & List - DLI", "description": "Minnesota contractor license list and DLI license lookup, businesses only: residential building contractors, remodelers, roofers, electrical, plumbing, HVAC and registered contractors, with phone, dates and status.", "version": "0.1", "x-build-id": "MwtlMgGqjPgWtcesa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/loomwise~minnesota-contractor-licenses/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-loomwise-minnesota-contractor-licenses", "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/loomwise~minnesota-contractor-licenses/runs": { "post": { "operationId": "runs-sync-loomwise-minnesota-contractor-licenses", "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/loomwise~minnesota-contractor-licenses/run-sync": { "post": { "operationId": "run-sync-loomwise-minnesota-contractor-licenses", "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": { "licensedWithinDays": { "title": "First licensed in the last N days", "minimum": 0, "maximum": 40000, "type": "integer", "description": "Only contractor businesses whose license or registration was first issued in the last N days, newest first. 0 = any date.", "default": 0 }, "categories": { "title": "Contractor categories", "type": "array", "description": "residential (building contractors, remodelers, roofers, manufactured home installers), electrical (Class A/B electrical, technology systems, sign), plumbing (plumbing contractors, pipelayers), hvac (mechanical contractor bond holders), registered (registered construction contractors). Empty = all.", "items": { "type": "string", "enum": [ "residential", "electrical", "plumbing", "hvac", "registered" ], "enumTitles": [ "Residential building, remodeling & roofing contractors", "Electrical, technology systems & sign contractors", "Plumbing contractors & pipelayers", "HVAC / mechanical contractors (bond)", "Registered construction contractors" ] } }, "licenseNumbers": { "title": "Bulk license lookup", "type": "array", "description": "Paste Minnesota DLI license or registration numbers (for example BC123456, EA001234, PC012345, IR123456). Returns those business licenses with any status and ignores the other filters. Unmatched numbers are listed in RUN_SUMMARY.", "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "Exact city names, for example Minneapolis, St Paul, Rochester. 'Saint Paul' and 'St. Paul' both work.", "items": { "type": "string" } }, "zipCodes": { "title": "ZIP codes or prefixes", "type": "array", "description": "For example 554 (Minneapolis) or 55901.", "items": { "type": "string" } }, "keywords": { "title": "Business name contains", "type": "array", "description": "Case-insensitive, any of these words, for example roofing, solar, heating.", "items": { "type": "string" } }, "minnesotaOnly": { "title": "Minnesota addresses only", "type": "boolean", "description": "Skip out-of-state contractors licensed in Minnesota.", "default": false }, "expiresFrom": { "title": "Expires from (YYYY-MM-DD)", "type": "string", "description": "Renewal prospecting: expiration date on or after." }, "expiresTo": { "title": "Expires to (YYYY-MM-DD)", "type": "string", "description": "Expiration date on or before." }, "licensedFrom": { "title": "First licensed from (YYYY-MM-DD)", "type": "string", "description": "Exact first-licensed date window, overrides 'last N days'." }, "licensedTo": { "title": "First licensed to (YYYY-MM-DD)", "type": "string", "description": "End of the first-licensed date window." }, "activeOnly": { "title": "Active licenses only", "type": "boolean", "description": "Only licenses with DLI status 'Issued'. Ignored in lookup mode.", "default": true }, "includeContactDetails": { "title": "Include business address and phone", "type": "boolean", "description": "Business address and phone of record, for registered entities only (never email).", "default": true }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 200000, "type": "integer", "description": "You pay per result. All categories together are about 25,000 active contractor businesses.", "default": 100 } } }, "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 } } } } } } } } } }