{ "openapi": "3.0.1", "info": { "title": "Michigan Contractor License Lookup & Verify (LARA)", "description": "Verify Michigan contractor and builder licenses using the public Michigan LARA lookup. Search by license number, business, or licensee name.", "version": "1.0", "x-build-id": "AutZTdX3OUGoczNHr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/muhammadafzal~michigan-contractor-license-lookup/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-muhammadafzal-michigan-contractor-license-lookup", "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/muhammadafzal~michigan-contractor-license-lookup/runs": { "post": { "operationId": "runs-sync-muhammadafzal-michigan-contractor-license-lookup", "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/muhammadafzal~michigan-contractor-license-lookup/run-sync": { "post": { "operationId": "run-sync-muhammadafzal-michigan-contractor-license-lookup", "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", "required": [ "searchMode", "licenseType", "maxResults" ], "properties": { "searchMode": { "title": "Search by", "enum": [ "LICENSE_NUMBER", "BUSINESS_NAME", "PERSON_NAME" ], "type": "string", "description": "Choose one search method. Use LICENSE_NUMBER for an exact LARA license number, BUSINESS_NAME for a partial business name, or PERSON_NAME with a last name and optional first name.", "default": "LICENSE_NUMBER" }, "licenseNumber": { "title": "LARA license number", "minLength": 3, "maxLength": 40, "type": "string", "description": "Use this for an exact public Michigan license number, such as `2101209706`. Required when Search by is Exact license number. Select the matching License type below; do not enter a contractor business registration or permit number.", "default": "2101209706" }, "businessName": { "title": "Business name", "maxLength": 255, "type": "string", "description": "Use this for a business-name search in LARA's public licensee lookup, for example `Northstar Builders`. Required when Search by is Business name. This is a name search, not a city, address, permit, or service-area search." }, "firstName": { "title": "First name", "maxLength": 70, "type": "string", "description": "Optional first-name filter for a person search, such as `Jordan`. Use together with Last name when Search by is Person name." }, "lastName": { "title": "Last name", "maxLength": 70, "type": "string", "description": "Use this for a person-name search, such as `Zago`. Required when Search by is Person name. The Actor returns license records from the selected LARA license type." }, "licenseType": { "title": "LARA license type", "enum": [ "Electrical Contractor", "Electrical Fire Alarm Contractor", "Electrical Registered Fire Alarm Cont", "Electrical Registered Sign Contractor", "Electrical Sign Contractor", "Elevator Contractor", "Manufactured Home Installer Servicer", "Mechanical Contractor", "Plumbing Contractor", "Residential Builder Branch Office", "Residential Builder Company", "Residential Builder Individual", "Residential Builder M and A Company", "Residential Builder M and A Individual", "Residential Builder Temp Mil Spouse Individual", "Residential Builder Temp Mil Spouse M and A Individual" ], "type": "string", "description": "Select the exact license category used by the LARA public lookup. The category must match the credential being searched; for example, an individual Residential Builder license differs from a Residential Builder Company license.", "default": "Residential Builder Individual" }, "maxResults": { "title": "Maximum license records (free plan: max 5)", "minimum": 1, "maximum": 10, "type": "integer", "description": "Set the maximum number of unique license records to return, from 1 to 10. Default 10. Verified free-plan runs are capped at 5 delivered records even when a higher value is requested; paid and agentic runs use the requested limit. Name searches read only the current LARA result page and report when more matches exist.", "default": 10 } } }, "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 } } } } } } } } } }