{
  "openapi": "3.0.1",
  "info": {
    "title": "Colorado Professional License Scraper",
    "description": "Colorado DORA professional license scraper & API: search licenses across boards and export license number, type, status, name, profession, address and issue/expiry dates. Professional license verification, compliance and lead generation — fast, no login.",
    "version": "1.0",
    "x-build-id": "lvM0z6rkXCFpi3TkW"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/haketa~colorado-professional-license-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-haketa-colorado-professional-license-scraper",
        "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/haketa~colorado-professional-license-scraper/runs": {
      "post": {
        "operationId": "runs-sync-haketa-colorado-professional-license-scraper",
        "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/haketa~colorado-professional-license-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-haketa-colorado-professional-license-scraper",
        "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": {
          "licenseTypes": {
            "title": "Professions / license types",
            "type": "array",
            "description": "Choose which professions to pull. Leave empty to include a broad mix across all license types. You can select as many as you like.",
            "items": {
              "type": "string",
              "enum": [
                "EC",
                "PC",
                "ME",
                "JW",
                "MP",
                "JP",
                "PE",
                "PLS",
                "ARC",
                "RN",
                "PN",
                "APN",
                "NA",
                "PA",
                "DR",
                "MD",
                "CPA",
                "REB",
                "COS",
                "BAR",
                "DEN",
                "DH",
                "PHA",
                "VET",
                "PSY",
                "LPC",
                "LCSW",
                "OT",
                "PT",
                "SLP",
                "MT",
                "CHR",
                "AP"
              ],
              "enumTitles": [
                "Electrical Contractor (EC)",
                "Plumbing Contractor (PC)",
                "Mechanical / HVAC (ME)",
                "Journeyman Wireman - Electrical (JW)",
                "Master Plumber (MP)",
                "Journeyman Plumber (JP)",
                "Professional Engineer (PE)",
                "Professional Land Surveyor (PLS)",
                "Architect (ARC)",
                "Registered Nurse (RN)",
                "Practical Nurse - LPN (PN)",
                "Advanced Practice Nurse (APN)",
                "Nurse Aide (NA)",
                "Physician Assistant (PA)",
                "Doctor / Physician (DR)",
                "Medical Doctor (MD)",
                "Certified Public Accountant (CPA)",
                "Real Estate Broker (REB)",
                "Cosmetologist (COS)",
                "Barber (BAR)",
                "Dentist (DEN)",
                "Dental Hygienist (DH)",
                "Pharmacist (PHA)",
                "Veterinarian (VET)",
                "Psychologist (PSY)",
                "Licensed Professional Counselor (LPC)",
                "Clinical Social Worker (LCSW)",
                "Occupational Therapist (OT)",
                "Physical Therapist (PT)",
                "Speech Language Pathologist (SLP)",
                "Massage Therapist (MT)",
                "Chiropractor (CHR)",
                "Acupuncturist (AP)"
              ]
            },
            "default": []
          },
          "statuses": {
            "title": "License statuses",
            "type": "array",
            "description": "Choose which license statuses to include. Leave empty to include every status. Select 'Active' only for a clean, currently-licensed lead list.",
            "items": {
              "type": "string",
              "enum": [
                "Active",
                "Expired",
                "Cancelled",
                "Revoked",
                "Surrendered",
                "Voluntary Surrender",
                "Inactive",
                "Retired",
                "Suspended",
                "Active - With Conditions",
                "Active - Provisional",
                "Active - Restricted"
              ],
              "enumTitles": [
                "Active",
                "Expired",
                "Cancelled",
                "Revoked",
                "Surrendered",
                "Voluntary Surrender",
                "Inactive",
                "Retired",
                "Suspended",
                "Active - With Conditions",
                "Active - Provisional",
                "Active - Restricted"
              ]
            },
            "default": []
          },
          "cities": {
            "title": "Cities",
            "type": "array",
            "description": "Pick one or more Colorado cities to focus on. Leave empty to include every city statewide. Need a city that isn't listed? Add it under 'Other cities' below.",
            "items": {
              "type": "string",
              "enum": [
                "Denver",
                "Colorado Springs",
                "Aurora",
                "Fort Collins",
                "Lakewood",
                "Littleton",
                "Pueblo",
                "Grand Junction",
                "Arvada",
                "Thornton",
                "Boulder",
                "Centennial",
                "Loveland",
                "Westminster",
                "Parker",
                "Greeley",
                "Longmont",
                "Highlands Ranch",
                "Englewood",
                "Castle Rock",
                "Broomfield",
                "Golden",
                "Brighton",
                "Commerce City",
                "Durango",
                "Montrose",
                "Windsor",
                "Wheat Ridge",
                "Lafayette",
                "Northglenn"
              ]
            },
            "default": []
          },
          "citiesCustom": {
            "title": "Other cities (optional)",
            "type": "array",
            "description": "Advanced: type any additional Colorado city names not offered in the dropdown above. Matching is case-insensitive.",
            "items": {
              "type": "string"
            }
          },
          "issuedAfter": {
            "title": "Issued on or after (optional)",
            "type": "string",
            "description": "Only include licenses first issued on or after this date. Handy for finding newly licensed professionals. Format: YYYY-MM-DD. Leave empty for no lower bound."
          },
          "issuedBefore": {
            "title": "Issued on or before (optional)",
            "type": "string",
            "description": "Only include licenses first issued on or before this date. Format: YYYY-MM-DD. Leave empty for no upper bound."
          },
          "maxRecords": {
            "title": "Max records",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of license records to return. Set 0 for unlimited (large professions can return hundreds of thousands of rows).",
            "default": 100
          },
          "pageSize": {
            "title": "Records per request (advanced)",
            "minimum": 100,
            "maximum": 50000,
            "type": "integer",
            "description": "How many records to fetch per data request. The default works well for almost everyone.",
            "default": 1000
          },
          "requestDelay": {
            "title": "Delay between requests (ms) (advanced)",
            "minimum": 0,
            "maximum": 5000,
            "type": "integer",
            "description": "Pause between data requests, in milliseconds. The default is polite and reliable.",
            "default": 200
          }
        }
      },
      "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}