{ "openapi": "3.0.1", "info": { "title": "IDFPR Illinois License Lookup - Roofing Contractors & Firms", "description": "Illinois IDFPR license list and lookup, businesses only: licensed roofing contractors, design firms, home inspectors, real estate firms and more, with status, dates, city, county.", "version": "0.1", "x-build-id": "vRywJGhs4cOXtWgg2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/loomwise~illinois-idfpr-business-licenses/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-loomwise-illinois-idfpr-business-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~illinois-idfpr-business-licenses/runs": { "post": { "operationId": "runs-sync-loomwise-illinois-idfpr-business-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~illinois-idfpr-business-licenses/run-sync": { "post": { "operationId": "run-sync-loomwise-illinois-idfpr-business-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": { "categories": { "title": "Business categories", "type": "array", "description": "Which IDFPR business licenses to return. Leave empty for all business categories.", "items": { "type": "string", "enum": [ "roofing", "design_firms", "home_inspection", "alarm_security_locksmith", "real_estate", "community_association_mgmt", "appraisal_mgmt", "accounting_firms", "collection_agencies", "auction_firms", "salons_barbershops", "pharmacies", "medical_professional_corps", "home_medical_equipment", "cannabis_dispensaries", "cemeteries" ], "enumTitles": [ "Roofing contractors", "Design firms (architecture, engineering, structural, land surveying)", "Home inspection companies", "Alarm contractors, security, detective and locksmith agencies", "Real estate brokerages and branch offices", "Community association (HOA) management firms", "Appraisal management companies", "CPA / public accounting firms", "Collection agencies", "Auction firms", "Salons and barbershops", "Pharmacies and drug distributors", "Medical and professional service corporations, PLLCs", "Home medical equipment providers", "Cannabis dispensing organizations", "Cemeteries" ] } }, "issuedWithinDays": { "title": "First licensed within the last N days", "minimum": 0, "maximum": 40000, "type": "integer", "description": "New-license leads: original issue date in the last N days. 0 = any issue date (full list).", "default": 0 }, "issuedFrom": { "title": "Issued from (YYYY-MM-DD)", "type": "string", "description": "Optional exact start of the original-issue-date window." }, "issuedTo": { "title": "Issued to (YYYY-MM-DD)", "type": "string", "description": "Optional exact end of the window." }, "licenseNumbers": { "title": "License numbers to look up / verify (optional)", "type": "array", "description": "Bulk IDFPR license lookup: paste business license numbers (e.g. 104020210). Each is returned with its status, expiration date and discipline flag, whatever its status. Overrides categories and the active-only filter. Not-found numbers are listed in RUN_SUMMARY.", "items": { "type": "string" } }, "counties": { "title": "Counties", "type": "array", "description": "Illinois counties, e.g. COOK, DUPAGE, LAKE, WILL.", "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "Exact city names, e.g. CHICAGO, NAPERVILLE.", "items": { "type": "string" } }, "zipCodes": { "title": "ZIP codes or prefixes", "type": "array", "description": "e.g. 606 for Chicago.", "items": { "type": "string" } }, "keywords": { "title": "Business name contains", "type": "array", "description": "e.g. roofing, exteriors, engineering.", "items": { "type": "string" } }, "illinoisOnly": { "title": "Illinois addresses only", "type": "boolean", "description": "Skip out-of-state firms that hold an Illinois license.", "default": false }, "activeOnly": { "title": "Active licenses only", "type": "boolean", "description": "Turn off to include expired, not-renewed, suspended and revoked licenses. Ignored for license-number lookups.", "default": true }, "includeDiscipline": { "title": "Include discipline case details", "type": "boolean", "description": "Case number, action and dates when IDFPR has disciplined the license.", "default": true }, "includeEducationProviders": { "title": "Include schools, courses and CE sponsors", "type": "boolean", "description": "Off by default: course and continuing-education registrations are not operating businesses.", "default": false }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 300000, "type": "integer", "description": "Newest licenses first. You pay per result.", "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 } } } } } } } } } }