# Denver & Aurora CO Contractor License Lookup & Leads Scraper (`scrapebench/colorado-contractor-leads-scraper`) Actor

Contractors licensed by the City and County of Denver (80 licence types) and the City of Aurora (19 types): building, roofing, plumbing, electrical, HVAC and more, with phone, email and street address. Export by type or look up a firm.

- **URL**: https://apify.com/scrapebench/colorado-contractor-leads-scraper.md
- **Developed by:** [ScrapeBench](https://apify.com/scrapebench) (community)
- **Categories:** Lead generation
- **Features:** Limited permissions
- **Stats:** 31 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$0.0025 / opportunities returned

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Colorado Contractor License Lookup & Leads Scraper

### Pain points

- Denver's licensee search stops at '100+' results and shows 10 rows a page, and its phone and email sit on each licensee's own page.
- Aurora's Online Contractor Lookup shows one licence type at a time, across 22 types, in a web page with no download (checked 2026-11-06), with its email column hidden behind a script.
- Colorado Springs' Pikes Peak Regional Building Department search shows one department at a time in a web page with no download.
- Colorado licenses no general contractor statewide: building contractors are licensed city by city.

### What we solve

- Denver's 80 contractor licence types read whole, by licence-number range so no search hits the 100-result cap, with phone, email and contact name from each licensee's page.
- Every Aurora licence type in one dataset: 6,144 firms from 6,568 Aurora listings (November 6, 2026), one row per firm with every type it holds.
- Colorado Springs: every PPRBD department whole (Building, Electrical, Mechanical, Plumbing, Fire, Sign, and the mechanic registers), 6,313 licences on 2026-11-16 with street address and phone (99.8%), status, expiry and insurance expiry dates.
- Filter by city (locality), licence type and expiry; look up a firm by name or Denver licence number.

### Summary

Contractors licensed by Colorado's largest cities, with contact details. Denver: the City and County of Denver's Accela licensee register, 80 contractor licence types (General Contractor Class A, Building Contractor Class B and B2, Residential Contractor Class C, the D specialty classes from roofing and siding to drywall and fences, electrical, plumbing, HVAC, refrigeration, fire protection, right of way and more). A Denver row is one licence: licence number, type, business name, street address, city, state and ZIP, issue and expiry dates with an Unexpired / Expired flag derived from the expiry, plus the phone, email and contact name from the licensee's own page, read when the row is delivered. Licences that expired more than 3 years ago are left out of exports. Aurora: every contractor the City of Aurora lists in its Online Contractor Lookup (19 types with listings: commercial and residential building, roofing, plumbing, electrical, mechanical systems, right of way, fire, sign, demolition and more), one row per firm (6,144 firms on November 6, 2026) with business name, the licence types, street address, phone (6,096 firms) and email (6,029); Aurora publishes no licence number, status or expiry. Many firms are based elsewhere in the Denver metro or out of state; the address is the one the city lists. Colorado Springs: the Pikes Peak Regional Building Department (Colorado Springs, El Paso County and its towns), all 8 departments (Building, Electrical, Fire Contractors, Fire Technicians and Installers, Heating Mechanics, Mechanical, Plumbing, Sign; 6,313 licences on November 16, 2026), one row per holder and licence class: business or mechanic name, licence class and description, street address, city, ZIP, phone, status, expiry and the workers' comp and liability insurance expiries; no email. Thornton: the city's licensed-contractors list (2,647 licences, November 2026) with phone and expiry. Exports read a stored copy; lookups search the cities live. Pay only per row returned.

### Who it's for

- Building-material, roofing and electrical suppliers selling to contractors licensed in Denver, Aurora, Colorado Springs and the Front Range
- General contractors finding licensed subcontractors by trade
- Lenders, insurers and software vendors building contractor lead lists with phone and email
- Homeowners and property managers checking that a firm holds a Denver or Aurora licence

### How to use

This actor does two jobs. Run it, then collect results from the run's dataset (export to JSON/CSV/Excel, or pull via the Apify API).

**Get a list (export):** no names, just filters; returns the whole matching list.

```json
{
  "localities": [
    "Denver"
  ],
  "categories": [
    "General Contractor - Class A"
  ],
  "expiry_statuses": [
    "Unexpired"
  ],
  "maxResults": 2000
}
```

**Check specific firms (lookup):** put company names or licence numbers in `mode`, `queries`; **Inputs** below says how each is matched.

```json
{
  "mode": "lookup",
  "queries": [
    "Roofing",
    "LIC00245385"
  ],
  "maxResults": 20
}
```

See **Inputs** below for every available field.

### What you get

One row per record:

| Field | Description |
|---|---|
| `business_name` | Business as the city lists it; name holds the same |
| `license_number` | Denver's licence number (LIC00245385); Aurora publishes none |
| `license_type` | The licence type (General Contractor - Class A, D-Siding … in Denver; Roofing Contractor, Electrical Contractor … in Aurora) |
| `classifications` | Aurora: every licence type the firm is listed under; Denver: the row's one type |
| `phone` | Phone; phone_e164 holds it as +1XXXXXXXXXX (Denver: from the licensee's page) |
| `email` | Email (Denver: from the licensee's page; the city's own licensing-desk address is never returned as a firm's) |
| `address` | Street address; city, address_state and zip_code beside it (extras.city_state_zip when Aurora's line does not split) |
| `expiration_date` | Licence expiry (YYYY-MM-DD), Denver only |
| `state` | CO: the licensing state; address_state is the address's own state |
| `extras.locality` | Which city the row comes from: Denver or Aurora |
| `extras.expiry_status` | Denver: Unexpired, Expired or No expiry date, derived from the expiry on the day of the copy (Denver publishes no status) |
| `extras.person_name` | Contact name from the licensee's page (Denver) |
| `source_url` | Denver: the licensee's own page; Aurora: the city's lookup page, tagged with the firm |

Sample:

```json
{
  "business_name": "WBB COLO INC",
  "license_number": "LIC00245385",
  "license_type": "General Contractor - Class A",
  "classifications": [
    "General Contractor - Class A"
  ],
  "phone": "9709777271",
  "phone_e164": "+19709777271",
  "email": "JTALBOT@WBBCONSTRUCTION.COM",
  "address": "1181 S HIGH ST",
  "city": "DENVER",
  "zip_code": "80210",
  "address_state": "CO",
  "state": "CO",
  "expiration_date": "2021-06-30",
  "source_url": "https://aca-prod.accela.com/DENVER/GeneralProperty/LicenseeDetail.aspx?LicenseeNumber=LIC00245385&LicenseeType=General+Contractor+-+Class+A#%7CWBB%20COLO%20INC%7C1181%20S%20HIGH%20ST",
  "extras": {
    "locality": "Denver",
    "expiry_status": "Expired",
    "person_name": "IGOR FLEYSHMAKHER"
  }
}
```

### Inputs

| Field | Required | Type | Default | Description |
|---|---|---|---|---|
| `mode` | no | string | `"auto"` | export: no names, just filters; returns the whole matching list. lookup / verify: put company names (matched if contained in the company name) or licence numbers (exact) in 'queries'. auto picks the mode for you. |
| `query` | no | string | — | A business name (or listing number) to look up live. Kept alongside 'queries' for saved tasks. |
| `queries` | no | array | `[]` | A business name (or listing number) to look up live. Several values in one run; combined with 'query'. |
| `locality` | no | string | — | Only listings in this locality. Kept alongside 'localities' for saved tasks. |
| `localities` | no | array | `[]` | Only listings in this locality. Several values in one run; combined with 'locality'. |
| `expiry_status` | no | string | — | Only listings in this expiry_status. Kept alongside 'expiry_statuses' for saved tasks. |
| `expiry_statuses` | no | array | `[]` | Only listings in this expiry_status. Several values in one run; combined with 'expiry_status'. |
| `categories` | no | array | `[]` | Only rows from this licence type (one or more). Available: Access Control System, Boilermaker, Building, Building Contractor - Class B, Building Contractor - Class B2, Class A General Contractor, Class B Building Contractor, Class C Residential Contractor, Class D Antenna - Cable, Class D Boiler, Class D Deck - Patio Cover, Class D Demolition - Mitigation, Class D Drywall, Class D Electrical, Class D Excavation - Grading, Class D Fence - Retaining Wall, Class D Fire Systems, Class D Framing, Class D Gas Piping, Class D Landscape - Irrigation, Class D Manufactured Home, Class D Masonry, Class D Mechanical, Class D Miscellaneous, Class D Plumbing, … (135 in all; an unknown name returns the full list, free). |
| `licenseTypes` | no | array | `[]` | Same filter as 'Licence type', under the name every state licence actor takes; the two lists are combined. |
| `expiresAfter` | no | string | — | Only licences expiring on or after this date (YYYY-MM-DD). Licences with no published expiry are left out when set. |
| `expiresBefore` | no | string | — | Only licences expiring on or before this date (YYYY-MM-DD): renewals coming due. |
| `includeContacts` | no | boolean | `true` | Where the board publishes no phone for a business, add one (with its website and street address when found), looked up by business name. Charged as a separate 'Contact details found' event only on a row that gets a phone; a row without one costs only the row price. Turn off for the licence list alone. |
| `maxResults` | no | integer | `500` | Per query in lookup mode; per run in export mode. |
| `proxyConfiguration` | no | object | `{"useApifyProxy": false}` | Used only for live lookups; exports read the stored snapshot. |

### Pricing (Pay Per Event)

You pay per result (`dataset-item`) — **no charge for empty runs**. Example: **1000 license matches** at *$0.004/result* ≈ **$4.00**.

Notices (unknown licence type, no match, source unavailable) are free. Until 2026-11-22 this actor bills $0.0025 per licence returned; from 2026-11-22 it bills $0.004.

### Use cases

- Sales lists: every Denver Class A general contractor with an unexpired licence, with phone, email and street address.
- Subcontractor sourcing: Denver or Aurora roofing, plumbing, mechanical or electrical contractors in one export.
- Renewal campaigns: Denver licences expiring in the next 90 days (Expires on or before).
- Licence checks: confirm a firm holds a Denver or Aurora licence, and for which types, before work starts.
- Colorado Springs leads: every PPRBD-licensed roofing or building contractor (Locality Colorado Springs, department Building) with phone and address.

### Why this actor

- Denver's whole register, not the first 100 rows of a search, with each licensee's phone and email.
- All 19 Aurora licence types in one dataset; the city's page shows one type at a time.
- Emails decoded: Aurora's page hides them behind a script.
- Pay per row; notices are free.

### Limitations & updates

Covers the City and County of Denver's contractor licence register (80 contractor licence types; licences expired more than 3 years ago left out of exports) the City of Aurora's contractor list (6,144 firms on 2026-11-06), the Pikes Peak Regional Building Department's 8 departments (6,313 licences on 2026-11-16; no email) and Thornton's list, not every Colorado contractor; state DORA licences are not included. Aurora publishes no licence number, status or expiry date. A few Aurora listings carry a short phone or an unsplit city line, kept as printed in extras. Exports come from a stored copy (its date is in the run log).

### FAQ

**Where does the data come from?**

Denver: the City and County of Denver's Accela Citizen Access licensee search (aca-prod.accela.com/DENVER), plus each licensee's own page for phone and email. Aurora: the City of Aurora's Online Contractor Lookup (apps2.auroragov.org/OnlineContractorLookup), which lists every contractor the city licenses, by licence type. Colorado Springs: the Pikes Peak Regional Building Department's contractor and mechanic search (pprbd.org), one department at a time. Thornton: the city's published licensed-contractors list. Exports read a stored copy (the run log gives its date); lookups search the cities live and fall back to the stored copy.

**Does it cover all of Colorado?**

No. Colorado licenses no general contractor statewide; cities license building contractors themselves. This actor reads Denver's, Aurora's, Colorado Springs' (PPRBD) and Thornton's lists, which also hold many firms based elsewhere in the Denver metro and out of state that are licensed to work there. Colorado's state electrical and plumbing licences (DORA) are not included. Other Colorado cities are added as they are read.

**Which fields are there?**

Denver: licence number, type, business name, street address, city, state, ZIP, issue and expiry dates, an Unexpired / Expired flag, and the phone, email and contact name from the licensee's page. Aurora: business name, licence type(s), street address, city, state, ZIP, phone and email; Aurora publishes no licence number, status or expiry date, so the Expires on or after / before and Expiry Status filters keep Denver rows only.

**Why one row per firm in Aurora but one per licence in Denver?**

Aurora lists a firm once per licence type with no licence number, so an Aurora row is one firm (its name and phone) with every type it is listed under, charged once. Denver numbers each licence, so a Denver row is one licence; a firm holding three Denver licence types has three rows. Exports leave out Denver licences that expired more than 3 years ago.

**How do I look up a firm?**

Put names or Denver licence numbers in queries and set mode to lookup. Aurora matches a name contained in the business name; Denver's own search matches from the start of the business name or licence number. Set Locality to search one city.

**How am I charged?**

One event per row returned. Notices are free.

### Guides & use cases

Written up on **[scrapebench.dev](https://scrapebench.dev)** — the bench that runs and verifies this actor against the live source every night:

- **How-to:** [How to run Denver & Aurora CO Contractor License Lookup & Leads Scraper](https://scrapebench.dev/guides/how-to-colorado-contractor-leads-scraper/)
- **Use case:** [Aurora CO Licensed Roofing Contractors](https://scrapebench.dev/use-cases/aurora-co-licensed-roofing-contractors/)

More actors, coverage and nightly verification results: **[scrapebench.dev](https://scrapebench.dev)**

### Works with AI assistants (MCP)

Callable as an MCP tool, so Claude, Cursor, VS Code Copilot and other MCP clients can run it directly. Grab the config from the [MCP tab](https://apify.com/scrapebench/colorado-contractor-leads-scraper/api/mcp) on this page — Apify hosts the server and keeps that snippet current, and OAuth signs you in on first connect, so no API token goes in your config file.

Then just ask:

> "List roofing contractors licensed by the City of Aurora, Colorado, with their phone, email and street address."

That is Locality Aurora, Licence type Roofing Contractor (628 listings on 2026-11-06). Keep maxResults small on a first call. Runs started this way bill exactly like any other run.

### Data & lawful use

This actor collects publicly available information that the City and County of Denver (Community Planning and Development, Contractor Licensing), the City of Aurora, Colorado (its Online Contractor Lookup), the City of Thornton, Colorado (its licensed-contractors list) and the Pikes Peak Regional Building Department (PPRBD: Colorado Springs, El Paso County and its towns) publishes for public
lookup — licence records, business listings and the contact details professionals list there.
Some of it identifies individuals (sole proprietors, licence holders, agents), so treat any
names, phone numbers and emails in your results as personal data.

When you run this actor, you decide what is collected and what it is used for, so you are the
controller of that data and we act only as your processor (Apify Standard Actor Contract).
You need a lawful basis for your use, must honour opt-out and deletion requests, and must
follow the marketing rules that apply to you (CAN-SPAM, TCPA, GDPR, CCPA and similar).
Don't use the output for unsolicited bulk messaging, for screening covered by the FCRA, or
for anything the source's own terms forbid.

Your results are stored in your own Apify account. We don't keep a copy of your results and
don't sell or share them.

### Disclaimer

This is an independent tool. It is not affiliated with, endorsed by or sponsored by
the City and County of Denver (Community Planning and Development, Contractor Licensing), the City of Aurora, Colorado (its Online Contractor Lookup), the City of Thornton, Colorado (its licensed-contractors list) and the Pikes Peak Regional Building Department (PPRBD: Colorado Springs, El Paso County and its towns). Names and marks are used only to describe the data source. Records are
provided as published by the source and may be out of date or incomplete. For anything
consequential (hiring, a permit, a legal decision), confirm the record with the issuing
agency. You are responsible for making sure your use complies with applicable law and the
source's terms.

### Need help?

Open an issue on this actor's **Issues** tab and we'll respond there. Bug reports, missing
fields and feature requests are all welcome. Guides and examples: [scrapebench.dev](https://scrapebench.dev).

If you are a person named in this data and want your record removed from our copy, email
apify-help@scrapebench.dev; the source agency remains the official record.

Your run may be used to improve our services. If something looks off, or you want this actor to fit your use better, please share your run data with us: [Apify Console → Settings → Security → Share run data with developers](https://console.apify.com/settings/security). It lets us see exactly what went wrong and keep improving the actor.

If this actor saved you time, a short review on its Store page helps other buyers find it.

# Actor input Schema

## `mode` (type: `string`):

export: no names, just filters; returns the whole matching list. lookup / verify: put company names (matched if contained in the company name) or licence numbers (exact) in 'queries'. auto picks the mode for you.

## `query` (type: `string`):

A business name (or listing number) to look up live. Kept alongside 'queries' for saved tasks.

## `queries` (type: `array`):

A business name (or listing number) to look up live. Several values in one run; combined with 'query'.

## `locality` (type: `string`):

Only listings in this locality. Kept alongside 'localities' for saved tasks.

## `localities` (type: `array`):

Only listings in this locality. Several values in one run; combined with 'locality'.

## `expiry_status` (type: `string`):

Only listings in this expiry_status. Kept alongside 'expiry_statuses' for saved tasks.

## `expiry_statuses` (type: `array`):

Only listings in this expiry_status. Several values in one run; combined with 'expiry_status'.

## `categories` (type: `array`):

Only rows from this licence type (one or more). Available: Access Control System, Boilermaker, Building, Building Contractor - Class B, Building Contractor - Class B2, Class A General Contractor, Class B Building Contractor, Class C Residential Contractor, Class D Antenna - Cable, Class D Boiler, Class D Deck - Patio Cover, Class D Demolition - Mitigation, Class D Drywall, Class D Electrical, Class D Excavation - Grading, Class D Fence - Retaining Wall, Class D Fire Systems, Class D Framing, Class D Gas Piping, Class D Landscape - Irrigation, Class D Manufactured Home, Class D Masonry, Class D Mechanical, Class D Miscellaneous, Class D Plumbing, … (135 in all; an unknown name returns the full list, free).

## `licenseTypes` (type: `array`):

Same filter as 'Licence type', under the name every state licence actor takes; the two lists are combined.

## `expiresAfter` (type: `string`):

Only licences expiring on or after this date (YYYY-MM-DD). Licences with no published expiry are left out when set.

## `expiresBefore` (type: `string`):

Only licences expiring on or before this date (YYYY-MM-DD): renewals coming due.

## `includeContacts` (type: `boolean`):

Where the board publishes no phone for a business, add one (with its website and street address when found), looked up by business name. Charged as a separate 'Contact details found' event only on a row that gets a phone; a row without one costs only the row price. Turn off for the licence list alone.

## `maxResults` (type: `integer`):

Per query in lookup mode; per run in export mode.

## `proxyConfiguration` (type: `object`):

Used only for live lookups; exports read the stored snapshot.

## Actor input object example

```json
{
  "mode": "auto",
  "queries": [],
  "localities": [],
  "expiry_statuses": [],
  "categories": [],
  "licenseTypes": [],
  "includeContacts": true,
  "maxResults": 500,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

One row per business listing; notices are free.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapebench/colorado-contractor-leads-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("scrapebench/colorado-contractor-leads-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call scrapebench/colorado-contractor-leads-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapebench/colorado-contractor-leads-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/TrJINsslJxKEAdVy1/builds/g16rDA5EapPPGb71U/openapi.json
