# Denver Business License Search (open data) (`pennant/denver-business-licenses`) Actor

Search active City and County of Denver business licences — restaurants, liquor, marijuana, tobacco, parking, repair garages, kennels and more — by type, application date, expiration, name or ZIP. Businesses only; street address off by default. Official open data.

- **URL**: https://apify.com/pennant/denver-business-licenses.md
- **Developed by:** [Pennant](https://apify.com/pennant) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 licence results

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

## Denver Business License Search (open data)

**Pennant** — Official public records as clean, tested data feeds.

Search the City and County of Denver's list of **active business licences** — restaurants and food commissaries, liquor licences, marijuana stores and cultivation facilities, tobacco retailers, parking lots and garages, motor-vehicle repair garages, kennels, massage and body-art businesses, second-hand dealers, lodging and more — published as open data and refreshed about monthly. Each result is **one licence** at its primary location, with the holder's name and trade name, application date and expiration date.

This is not an official verification service. Confirm a licence with the City and County of Denver before relying on it.

**Source:** City and County of Denver, *Active Business Licenses* (CC BY 3.0), via data.colorado.gov (`s9wt-dsfz`) · Attribution: City and County of Denver · refreshed about monthly. Denver's use constraints and Colorado's required disclaimer are in the "Data source, licence and disclaimers" section below.

### Who it's for

Food, beverage and restaurant-supply distributors, POS and payments vendors, commercial insurance agents, cannabis-industry suppliers, parking and facility-services companies, and market researchers who want a clean list of licensed Denver businesses — or a feed of **new applications** and a **renewal watch list**.

**Use cases**

- A monthly list of new retail-food and combined licences in Denver, by application date.
- Liquor licences or tasting permits in a few ZIP codes.
- A renewal watch list of marijuana stores or tobacco retailers expiring next quarter.
- A clean list of licensed parking lots and repair garages for facility-services outreach.

### Input examples

Newest retail-food licences:

```json
{ "licenseTypes": ["Retail Food"], "sort": "newest", "maxItems": 200 }
```

Licences applied for in the last month (any type except rentals):

```json
{ "appliedFrom": "2026-10-01", "appliedTo": "2026-10-31", "maxItems": 1000 }
```

Liquor tasting permits in two ZIP codes:

```json
{ "licenseTypes": ["Liquor"], "licenseSubTypes": ["Tastings"], "zipCodes": ["80202", "80205"] }
```

Marijuana stores expiring in the next quarter:

```json
{ "licenseTypes": ["Marijuana Store"], "expiresFrom": "2026-12-01", "expiresTo": "2027-02-28", "sort": "expiration" }
```

The first example at a glance:

| Field | Example value | What it does |
|---|---|---|
| `licenseTypes` | `["Retail Food"]` | One licence type |
| `sort` | `newest` | Newest application first |
| `maxItems` | `200` | Stop after 200 licences |

### Input

| Field | Type | Notes |
|---|---|---|
| `licenseTypes` | string list | Exact type names as published (case-insensitive), e.g. `Retail Food`, `Combined License`, `Liquor`, `Retail Tobacco Store`, `Marijuana Store`, `Parking Lot, Garage`, `Garage - Repair of Motor Vehic`. Empty = every type except residential and short-term rentals. |
| `licenseSubTypes` | string list | Mainly for `Liquor`: `Retail`, `Tastings`, `Art Gallery Permit`, `Club`. |
| `includeRentalLicenses` | boolean | **Default off.** Adds Residential Rental Property and Short Term Rental licences (company landlords only; see privacy). |
| `nameContains` | string | Case-insensitive substring of the holder or trade name. |
| `licenseNumbers` | string list | Denver business file numbers (BFN), e.g. `2024-BFN-0031073`. |
| `zipCodes` | string list | 5-digit ZIPs of the licensed location. |
| `appliedFrom` / `appliedTo` | YYYY-MM-DD | Inclusive application-date range (the source has no separate issue date). |
| `expiresFrom` / `expiresTo` | YYYY-MM-DD | Inclusive expiration-date range. |
| `sort` | `newest` (default), `oldest`, `name`, `expiration`, `licenseNumber` | Application-date sorts skip the few rows without a date. |
| `maxItems` | integer | Default 100. Each licence is one billable event. |
| `includeStreetAddress` | boolean | **Default off.** Adds the street line of the licensed location. |
| `includeCoordinates` | boolean | **Default off.** Adds the source's State Plane x/y (EPSG:2877, US survey feet). |
| `requestDelayMs`, `maxRetries` | integers | Politeness delay (default 1,100 ms) and retries. |

Size on 2026-11-16 (source, before the privacy filter; changes monthly): 56,468 rows / 39,850 licences. Residential Rental Property ~47,200 rows and Short Term Rental ~2,050 rows; all other types together 7,220 licences (Retail Food 2,591, Combined License 2,015, Retail Tobacco Store 503, Marijuana Store 242, Parking Lot/Garage 217, …).

### Sample output (one item per licence)

Street address and coordinates are omitted under the default privacy setting:

```json
{
  "licenseNumber": "2026-BFN-0022596",
  "licenseType": "Retail Food",
  "licenseSubType": null,
  "licenseStatus": "License Issued - Active",
  "entityName": "Honey Pig Cafe 4 LLC",
  "tradeName": "Miya Moon",
  "entityNameHidden": false,
  "applicationDate": "2026-10-07",
  "expirationDate": "2027-10-07",
  "businessAddress": { "street": null, "zip": "80222-7643" },
  "coordinates": null,
  "jurisdiction": "City and County of Denver, CO",
  "sourceReportDate": "2026-11-02",
  "sourceDataset": "https://data.colorado.gov/d/s9wt-dsfz",
  "sourceRecordUrl": "https://data.colorado.gov/resource/s9wt-dsfz.json?bfn=2026-BFN-0022596&primary_address_flag=Y",
  "retrievedAt": "2026-11-16T06:58:19.526Z"
}
```

The run also writes `RUN_SUMMARY` (counts, including skipped licences) and `SOURCE_NOTICE` (attribution and disclaimers).

**Example output as a table** (fictional rows, key columns only; street fields are null by default and not shown):

| licenseNumber | licenseType | entityName | tradeName | applicationDate | expirationDate | zip |
|---|---|---|---|---|---|---|
| 2026-BFN-0090001 | Retail Food | Mile High Bagel Co LLC | Mile High Bagels | 2026-10-02 | 2027-10-02 | 80206 |
| 2026-BFN-0090002 | Liquor | Larimer Street Wine Bar LLC | null | 2026-09-28 | 2027-09-28 | 80202 |
| 2026-BFN-0090003 | Garage - Repair of Motor Vehic | Platte Valley Auto Inc | Platte Valley Auto | 2026-09-15 | 2027-09-15 | 80211 |

### Privacy defaults

- **Businesses only (always on):** a licence whose holder looks like a person's name (sole proprietors, private landlords) is skipped and counted in `RUN_SUMMARY.skippedLikelyIndividuals`. If a person holds the licence under a business-style trade name that does not repeat their own name (e.g. "… LIQUOR STORE"), the trade name is kept, the holder name is hidden (`entityNameHidden: true`) and no raw-record link is given. A name search never matches on a hidden holder name. The test is a word heuristic (LLC, INC, CORP… or trade words such as CAFE, LIQUOR, PARKING); a business with an unusual name and no such word is skipped too.
- **Rentals off by default:** Residential Rental Property and Short Term Rental licences are mostly held by individuals at their own address, so they are excluded unless you ask for them; even then only company landlords are returned.
- **Street address and coordinates off by default:** only the ZIP unless you switch them on; the columns are not even requested otherwise.
- The source has no phone or email columns, and none are output.

### Limitations

- Active City and County of Denver business licences only (the source lists only "License Issued - Active"). One record per licence, at its primary location; a licence's other locations are not listed.
- The only date besides expiration is the **application date**, and a few rows have none.
- Refreshed monthly by the City (`sourceReportDate`); a just-issued licence can take a month to appear.
- Licence type names are passed through as published, including truncations such as `Garage - Repair of Motor Vehic`.

### Data source, licence and disclaimers

City and County of Denver, **Active Business Licenses** ([Denver Open Data Catalog](https://opendata-geospatialdenver.hub.arcgis.com/)), republished on the Colorado Information Marketplace as dataset `s9wt-dsfz` ([data.colorado.gov](https://data.colorado.gov/d/s9wt-dsfz)). The Denver Open Data Catalog is published under the **Creative Commons Attribution 3.0** licence (CC BY 3.0); the Colorado portal lists the dataset as Public Domain. **Attribution: City and County of Denver.** The data has been modified by this tool (one record per licence, personal-name holders removed, dates reformatted).

Denver's use constraints: the City and County of Denver provides the data "as is" without warranty of any kind, is not liable for damages arising from its use, and the data is not for engineering purposes.

State of Colorado disclaimer (required by the [data.colorado.gov terms](https://data.colorado.gov/terms)):

> The data made available here has been modified for use from its original source, which is the State of Colorado.
> THE STATE OF COLORADO MAKES NO REPRESENTATIONS OR WARRANTY AS TO THE COMPLETENESS, ACCURACY, TIMELINESS, OR CONTENT OF
> ANY DATA MADE AVAILABLE THROUGH THIS SITE. THE STATE OF COLORADO EXPRESSLY DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR
> IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. The data is subject
> to change as modifications and updates are complete. It is understood that the information contained in the Web feed
> is being used at one's own risk.

robots.txt `Crawl-delay: 1` and `/resource/` not disallowed; the Actor waits at least 1.1 seconds between pages and identifies itself. Not affiliated with or endorsed by the City and County of Denver or the State of Colorado.

### Pricing

Pay per event, billed by Apify:

| Event | Price |
|---|---|
| Run start (`apify-actor-start`) | $0.005 per run |
| Each licence returned (`result`) | $0.002 per licence |

**Worked example:** one run that returns 200 licences costs $0.005 + 200 × $0.002 = **$0.405**. A run of 1,000 licences costs **$2.005**.

To control spend, set `maxItems` (the Actor never returns more), and set a maximum cost per run in Apify. The Actor stops cleanly when it reaches the caller's max charge, and the licences already returned are kept.

### FAQ

**What does it cover, and what doesn't it?**

Active business licences issued by the City and County of Denver, one record per licence at its primary location. It does not cover expired licences, other Colorado cities, or a licence's secondary locations. Residential and short-term rental licences are excluded unless you turn on `includeRentalLicenses`.

**What happens to personal names and addresses?**

Licences held under what looks like a person's name are always skipped, unless the person trades under a business-style name; then only the trade name is returned. Rentals are off by default, and even when on only company landlords are returned. Street address and coordinates are off unless you turn them on. There are no phone or email columns.

**Is this official data or a scrape?**

Official open data. The Actor reads each government portal's documented Socrata API, at a polite pace (at least 1.1 seconds between pages). It does not log in anywhere or scrape a private website.

**How do I cap the cost of a run?**

Set `maxItems`; each returned record is one billable result. The default is 100. You can also set a maximum cost per run in Apify, and the Actor stops cleanly when it reaches it.

**How fresh is the data?**

The City refreshes the dataset about monthly (see `sourceReportDate`), so a just-issued licence can take a month to appear. Every run reads the current copy.

**Is Pennant affiliated with the source?**

No. Pennant is not affiliated with or endorsed by the City and County of Denver or the State of Colorado. The source agency is the authoritative record; confirm anything important with it.

**Where do I get help?**

Email 51wrw1aj@mail.grokbot.com. For a bad or unexpected record, include the run ID and the record's ID or licence number.

### For AI agents

- **Purpose:** list or search active Denver (Colorado) business licences by type, dates, name or ZIP.
- **Call when:** the user wants Denver restaurant, liquor, cannabis, tobacco, parking or repair-garage business leads, a new-licence feed, a renewal watch list, or a licence lookup by BFN.
- **Minimal input:** `{}` (newest applications first, all non-rental types).
- **Cost control:** one `result` event per licence; set `maxItems`.

# Actor input Schema

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

Exact licence type names as published, case-insensitive, e.g. Retail Food, Combined License, Liquor, Retail Tobacco Store, Marijuana Store, Parking Lot, Garage, Garage - Repair of Motor Vehic, Wholesale Food, Kennel, Second Hand Dealer, Massage Business, Body Art Est - Permanent, Lodging Facility. Empty = every type except residential and short-term rentals.

## `licenseSubTypes` (type: `array`):

Optional, case-insensitive. Mainly for Liquor: Retail, Tastings, Art Gallery Permit, Club.

## `includeRentalLicenses` (type: `boolean`):

Also return Residential Rental Property and Short Term Rental licences when no licence types are given. Most of these are held by private individuals and are skipped by the personal-name filter; only company landlords remain.

## `nameContains` (type: `string`):

Case-insensitive substring of the licence holder or trade name (at least 2 characters).

## `licenseNumbers` (type: `array`):

Denver business file numbers, e.g. 2024-BFN-0031073.

## `zipCodes` (type: `array`):

5-digit ZIPs of the licensed location (ZIP+4 values match by prefix).

## `appliedFrom` (type: `string`):

YYYY-MM-DD, inclusive. The source publishes the application date (no separate issue date). With sort=newest this is a new-licence feed.

## `appliedTo` (type: `string`):

YYYY-MM-DD, inclusive.

## `expiresFrom` (type: `string`):

YYYY-MM-DD, inclusive (renewal watch lists).

## `expiresTo` (type: `string`):

YYYY-MM-DD, inclusive.

## `sort` (type: `string`):

Result order. Application-date sorts skip the few rows without a date.

## `maxItems` (type: `integer`):

Hard cap on results (each result is one billable event).

## `includeStreetAddress` (type: `boolean`):

If on, the licensed location's street line is returned; otherwise only the ZIP.

## `includeCoordinates` (type: `boolean`):

If on, the source's State Plane x/y coordinates (EPSG:2877, US survey feet) are returned.

## `requestDelayMs` (type: `integer`):

Politeness delay between API pages (robots.txt Crawl-delay: 1).

## `maxRetries` (type: `integer`):

Retries on timeouts, HTTP 408/429/5xx with exponential backoff and Retry-After.

## Actor input object example

```json
{
  "licenseTypes": [
    "Retail Food"
  ],
  "includeRentalLicenses": false,
  "sort": "newest",
  "maxItems": 100,
  "includeStreetAddress": false,
  "includeCoordinates": false,
  "requestDelayMs": 1100,
  "maxRetries": 4
}
```

# Actor output Schema

## `licences` (type: `string`):

No description

## `runSummary` (type: `string`):

No description

## `sourceNotice` (type: `string`):

No description

# 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 = {
    "licenseTypes": [
        "Retail Food"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("pennant/denver-business-licenses").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 = { "licenseTypes": ["Retail Food"] }

# Run the Actor and wait for it to finish
run = client.actor("pennant/denver-business-licenses").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 '{
  "licenseTypes": [
    "Retail Food"
  ]
}' |
apify call pennant/denver-business-licenses --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,pennant/denver-business-licenses"
        }
    }
}
```

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/hK9MvmVVzXTC0gKwe/builds/Ai6RcxdD3cAwyvRSO/openapi.json
