# Connecticut Contractor License Search (open data) (`pennant/ct-contractor-licenses`) Actor

Search Connecticut contractor registrations held by businesses (home improvement, new home construction, major and demolition) by name, credential number, status, city, ZIP or date. Official state open-data API. Business entities only; no personal names; street addresses off by default.

- **URL**: https://apify.com/pennant/ct-contractor-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 credential 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

## Connecticut Contractor License Search (open data)

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

Search the State of Connecticut's "State Licenses and Credentials" open data for **contractor registrations held by businesses**. Default types are home improvement (HIC), new home construction (NHC), major (MCO) and demolition (DMCR) contractors. Sort by newest issue date for a **new-contractor feed**, or by soonest expiration for **renewals coming due**.

This is not an official verification service. Confirm a credential with the State before relying on it.

**Source:** Connecticut Open Data, *State Licenses and Credentials* (`ngch-56tr`), Public Domain · Department of Administrative Services & Department of Consumer Protection · updated daily. Full credit and terms are in the "Data source and license" section below.

### Who it's for

Building-supply dealers, contractor insurance and bonding agents, field-service and estimating software vendors, and researchers who want a list of registered Connecticut contractor businesses — or a weekly feed of new ones.

**Use cases**

- A weekly feed of newly registered home-improvement contractors in your sales territory (`credentialTypes: ["HIC"]`, `sort: "newest"`).
- A renewal watch list: major or new-home contractors whose registration expires next quarter.
- A clean list of active, in-state contractor businesses in a set of ZIP codes for a mailing or territory plan.
- Checking that a list of contractor businesses you already have still shows an active registration (by credential number).

### Input examples

New home-improvement and new-home-construction registrations this month:

```json
{ "credentialTypes": ["HIC", "NHC"], "dateField": "issue", "dateFrom": "2026-11-01", "sort": "newest", "maxItems": 500 }
```

Major contractors whose registration expires in the next quarter:

```json
{ "credentialTypes": ["MCO"], "dateField": "expiration", "dateFrom": "2026-12-01", "dateTo": "2027-02-28", "sort": "expiration" }
```

Active in-state home improvement contractors in a set of ZIPs:

```json
{ "credentialTypes": ["HIC"], "states": ["CT"], "zipCodes": ["06492", "06511"], "activeOnly": true, "sort": "name", "maxItems": 200 }
```

The first example at a glance:

| Field | Example value | What it does |
|---|---|---|
| `credentialTypes` | `["HIC", "NHC"]` | Home improvement and new home construction |
| `dateField` / `dateFrom` | `issue` / `2026-11-01` | Issued on or after this date |
| `sort` | `newest` | Newest issue date first |
| `maxItems` | `500` | Stop after 500 credentials |

### Input

| Field | Type | Notes |
|---|---|---|
| `credentialTypes` | string list | Default: `HIC`, `NHC`, `MCO`, `DMCR`. Also accepted: `53` asbestos, `50` lead abatement, `51` lead consultant, `PEC` engineering, `ARC` architecture, `LSC` land surveying, `LARC` landscape architecture, `PMBR` pesticide business, `CRNR` crane. Other codes are passed through, still businesses only. |
| `nameContains` | string | Case-insensitive substring of the business or DBA name. |
| `licenseNumbers` | string list | Full credential codes, e.g. `HIC.0581407`. |
| `activeOnly` | boolean | **Default on.** Turn off to include inactive, lapsed, denied or pending credentials. |
| `statuses` | string list | Optional exact statuses (ACTIVE, APPROVED, LAPSED, …). Combine with `activeOnly: false` for non-active statuses. |
| `cities`, `states`, `zipCodes` | string lists | Business-address filters. Many out-of-state companies are registered in Connecticut; use `states: ["CT"]` for in-state addresses only. |
| `dateField` | `issue` (default), `effective`, `expiration` | Which date `dateFrom` / `dateTo` apply to. |
| `dateFrom` / `dateTo` | YYYY-MM-DD | Inclusive. |
| `entitiesOnly` | boolean | **Default on.** Skip rows whose business and DBA names both look like a person's name. |
| `sort` | `newest` (default), `expiration`, `name` | Date sorts skip rows without that date. |
| `maxItems` | integer | Default 100. Each result is one billable event. |
| `includeStreetAddress` | boolean | **Default off.** Only city, state and ZIP unless you turn this on. Small contractors often register a home address. |
| `requestDelayMs`, `maxRetries` | integers | Politeness delay (default 1,100 ms) and retries. |

Approximate active business-held counts on 2026-11-15 (before the personal-name filter; they change daily): HIC ~20,200, NHC ~2,750, MCO ~1,890, DMCR ~630.

### Sample output (one item per credential)

Street address is omitted under the default privacy setting:

```json
{
  "licenseNumber": "HIC.0500855",
  "credentialId": "8967",
  "credentialCode": "HIC",
  "credentialName": "HOME IMPROVEMENT CONTRACTOR",
  "credentialSubcategory": null,
  "holderType": "CORPORATION",
  "businessName": "MAYTYME FARM INC",
  "dbaName": null,
  "status": "ACTIVE",
  "statusReason": "CURRENT",
  "active": true,
  "issueDate": null,
  "effectiveDate": "2026-04-01",
  "expirationDate": "2027-03-31",
  "businessAddress": { "street": null, "city": "YALESVILLE", "state": "CT", "zip": "064922200" },
  "licenseState": "CT",
  "recordRefreshedOn": "2026-02-24",
  "sourceDataset": "https://data.ct.gov/Licensing/State-Licenses-and-Credentials/ngch-56tr",
  "sourceRecordUrl": "https://data.ct.gov/resource/ngch-56tr.json?credentialid=8967",
  "retrievedAt": "2026-11-15T16:00:00.000Z"
}
```

The run also writes `RUN_SUMMARY` and `SOURCE_NOTICE`.

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

| licenseNumber | credentialCode | businessName | status | expirationDate | city | zip |
|---|---|---|---|---|---|---|
| HIC.0654321 | HIC | Harbor Light Remodeling LLC | ACTIVE | 2027-03-31 | NEW HAVEN | 06511 |
| NHC.0017890 | NHC | Ridgeline Homes Inc | ACTIVE | 2027-03-31 | GLASTONBURY | 06033 |
| MCO.0009876 | MCO | Shoreline Builders Corp | ACTIVE | 2027-06-30 | STAMFORD | 06902 |

### Privacy defaults

- **Business-entity holders only, always:** rows with holder type INDIVIDUAL, SOLE PROPRIETOR, EMPLOYEE ONLY, brand labels and similar are never requested. This server-side filter is not optional.
- **The source `name` column is never selected:** on business rows it can still be an owner's personal name. Output uses the published business name and DBA instead.
- **Skip personal names (default on):** rows whose business and DBA names both look like a person's name (common for single-member LLCs) are skipped and counted in `RUN_SUMMARY.skippedLikelyIndividuals`. When a personal business name has a trade-style DBA, the DBA is kept and the personal name is hidden. The test is a word heuristic (legal suffixes such as LLC or INC, or trade words such as REMODELING, ROOFING, LANDSCAPING). A business with an unusual name and no such word is skipped too, so turn this off if you need every business-entity row.
- **Street address off by default:** only city, state and ZIP unless `includeStreetAddress` is on.
- The source has no phone or email columns; none are output.

### Limitations

- Connecticut credentials only, and only those held by business entities.
- About a fifth of rows have no issue date; the newest and expiration sorts skip rows without that date.
- A few HIC issue dates are in the future (latest seen: 2027-03-31, the end of the current term); they are passed through as published.
- Newly approved registrations can show status APPROVED (active flag 1) before turning ACTIVE.
- HIC registrations renew on a 1 April–31 March cycle, so many effective dates are 2026-04-01.
- This is not a license verification service. Confirm a credential with the issuing agency before relying on it.

### Data source and license

Connecticut Open Data Portal, dataset **State Licenses and Credentials** (`ngch-56tr` on [data.ct.gov](https://data.ct.gov)), the eLicensing export, updated daily, about 2.1 million credential rows. Metadata licence: **Public Domain**. Attribution: Department of Administrative Services & Department of Consumer Protection. Terms ([data.ct.gov/terms](https://data.ct.gov/terms)): data is provided "as is" with no warranty of accuracy, timeliness or completeness; no clause restricts automated or commercial use. robots.txt `Crawl-delay: 1`; the Actor waits at least 1.1 seconds between pages. Not affiliated with or endorsed by the State of Connecticut.

### Pricing

Pay per event, billed by Apify:

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

**Worked example:** one run that returns 200 credentials costs $0.005 + 200 × $0.002 = **$0.405**. A run of 1,000 credentials 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 credentials already returned are kept.

### FAQ

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

Connecticut contractor credentials held by business entities: home improvement, new home construction, major and demolition contractors by default, plus asbestos, lead, engineering, architecture, surveying, pesticide and crane credentials on request. It does not cover individual tradespeople's licences (electricians, plumbers and so on), other states, or building permits.

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

Credentials held by individuals and sole proprietors are never requested, and the source's free-text `name` column (which can hold an owner's name) is never selected. Rows whose business and DBA names both look like a person's name are skipped by default. Only city, state and ZIP are returned unless you turn on `includeStreetAddress`. 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 State updates the dataset daily, and every run reads it live. Newly approved registrations can show status APPROVED before they turn ACTIVE.

**Is Pennant affiliated with the source?**

No. Pennant is not affiliated with or endorsed by the State of Connecticut, DAS or DCP. 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:** search Connecticut contractor registrations held by businesses, or list newly issued or soon-to-expire ones.
- **Call when:** the user wants Connecticut contractor leads, a new-contractor feed, or a renewal watch list.
- **Minimal input:** `{}` (defaults to active HIC/NHC/MCO/DMCR, newest issue first).
- **Cost control:** one `result` event per credential; set `maxItems`.

# Actor input Schema

## `credentialTypes` (type: `array`):

Connecticut credential codes, any match. Contractors: HIC (home improvement contractor), NHC (new home construction contractor), MCO (major contractor), DMCR (demolition contractor), 53 (asbestos contractor), 50 (lead abatement contractor), 51 (lead consultant contractor). Firms: PEC (professional engineering), ARC (architecture), LSC (land surveying), LARC (landscape architecture). Other: PMBR (pesticide application business), CRNR (crane registration). Only credentials held by business entities are returned.

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

Case-insensitive substring of the business or DBA name.

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

Full credential codes, e.g. HIC.0581407.

## `activeOnly` (type: `boolean`):

Only credentials the State marks as active. Turn off to include inactive, lapsed, denied or pending ones.

## `statuses` (type: `array`):

Optional exact statuses, e.g. ACTIVE, INACTIVE, APPROVED, PENDING, QUALIFIED, LAPSED, SUSPENDED, REVOKED, DENIED (case-insensitive). Combine with Active only = off for non-active statuses.

## `cities` (type: `array`):

Exact business-address city names, case-insensitive.

## `states` (type: `array`):

2-letter business-address states (many out-of-state contractors are registered in Connecticut).

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

5-digit ZIPs; ZIP+4 values match by prefix.

## `dateField` (type: `string`):

Which date Date from / Date to filter.

## `dateFrom` (type: `string`):

YYYY-MM-DD, inclusive.

## `dateTo` (type: `string`):

YYYY-MM-DD, inclusive.

## `entitiesOnly` (type: `boolean`):

Holder type is always a business entity. With this on, rows whose business and DBA names both look like a person's name (common for single-member LLCs) are skipped, and a personal business name is hidden when a trade-style DBA exists. Turn off to keep every business-entity row as published.

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

Result order. Date sorts skip rows without that date.

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

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

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

If on, the street line is returned too; otherwise only city, state and ZIP. Small contractors often register a home address.

## `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
{
  "credentialTypes": [
    "HIC",
    "NHC",
    "MCO",
    "DMCR"
  ],
  "activeOnly": true,
  "dateField": "issue",
  "entitiesOnly": true,
  "sort": "newest",
  "maxItems": 100,
  "includeStreetAddress": false,
  "requestDelayMs": 1100,
  "maxRetries": 4
}
```

# Actor output Schema

## `credentials` (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 = {
    "credentialTypes": [
        "HIC",
        "NHC",
        "MCO",
        "DMCR"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("pennant/ct-contractor-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 = { "credentialTypes": [
        "HIC",
        "NHC",
        "MCO",
        "DMCR",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("pennant/ct-contractor-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 '{
  "credentialTypes": [
    "HIC",
    "NHC",
    "MCO",
    "DMCR"
  ]
}' |
apify call pennant/ct-contractor-licenses --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,pennant/ct-contractor-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/nDf1Z0fYCfUhuIxQA/builds/N2hSB39fdtqSwpQ7f/openapi.json
