← Use cases

Use case

Build a Hartford County Home Improvement Contractor List

Pull every active Connecticut home improvement contractor registered in Hartford County from DCP's open data - name, registration number, town and expiration in one CSV.

Say you run the trade programme for a building-products distributor with three branches around Hartford, and next quarter you are launching a contractor rewards card. The people you want signed up are Connecticut’s registered Home Improvement Contractors — the remodellers, siding crews, deck and kitchen outfits who buy in small quantities every week. You want the Hartford County roster once to seed the campaign, and then the same roster every quarter, so lapsed registrations stop getting mail and newly registered outfits get a welcome pack in their first month.

The state already keeps that list. The awkward part is that it does not keep it by county.

The manual way, and what it costs

The public search form on CT DCP (Socrata)
CT DCP (Socrata) — the official search. One record at a time.

Start with the honest version: this data is free and it is downloadable. The Department of Consumer Protection publishes every Home Improvement Contractor credential on data.ct.gov as an open Socrata dataset, with a filter panel and an Export button. Nobody is stopping you — there is no login, no CAPTCHA and no anti-bot wall to beat.

What the dataset does not have is a county column. It has a ZIP code. So “Hartford County” is not a filter you can tick; it is a join you have to bring yourself — a CT ZIP-to-county table, pasted into a second sheet, VLOOKUPed against 130,000-odd rows, then filtered down to the towns you actually cover. If you need this list once, go and do that. It is an afternoon, the data is the same data, and you do not need to pay anyone.

The afternoon stops being a bargain when the word once stops being true. Every quarterly refresh is a fresh download, the same ZIP join rebuilt, the same status filter reapplied, and a manual dedupe against what you imported last time to work out who is new and who has gone. Do that four times a year across a couple of counties and you have quietly given someone a recurring chore that a scheduled run does for pennies.

The faster way

Connecticut Contractor Directory & Leads Scraper (DCP) does the same search once and hands back every row at once.

{
  "county": "Hartford",
  "statusFilter": "Active",
  "maxResults": 500
}

statusFilter: "Active" is pushed down to the DCP API as a filter, so inactive and revoked credentials never get downloaded in the first place — for a rewards-card campaign you only want people who can legally take the work. county: "Hartford" is the part the source cannot do: the actor pages the whole registry and keeps the rows whose ZIP falls in Hartford County, using its built-in CT ZIP-to-county map. maxResults counts matched rows, not scanned ones, and the run stops the moment it hits the cap — so 500 is a deliberate first look at an arbitrary slice of the county, not the best 500. Confirm the rows look right, then raise the cap and take the whole county.

What comes back

{
  "county": "Hartford",
  "person_name": "JOHN SMITH",
  "business_name": "HARTFORD HOME PROS LLC",
  "credential_type": "HIC",
  "credential_number": "HIC.0567890",
  "status": "Active",
  "issue_date": "2020-03-15T00:00:00.000",
  "effective_date": "2020-03-15T00:00:00.000",
  "expiration_date": "2026-03-15T00:00:00.000",
  "city": "HARTFORD",
  "state_code": "CT",
  "zip_code": "06103",
  "source_url": "https://data.ct.gov/Business/Connecticut-Home-Improvement-Contractors/5r9m-qgni"
}
FieldExample valueMeaning
countyHartfordCT county derived from the contractor’s ZIP code (null for out-of-state addresses or unrecognised ZIPs)
person_nameJOHN SMITHRegistrant / owner name as published by the DCP
business_nameHARTFORD HOME PROS LLCLicensed business name
credential_typeHICCredential type (HIC — Home Improvement Contractor)
credential_numberHIC.0567890DCP credential number (e.g. HIC.0567890)
statusActiveCredential status (e.g. Active, Inactive, Revoked)

For a trade programme, credential_number is the field that does the quiet work: it is a state-issued identifier that does not change when a business restyles its name or moves office, so it is the key your CRM should dedupe on. expiration_date is what turns a flat list into a sequence — a registration expiring in six weeks is a different conversation from one with two years left. person_name alongside business_name matters more here than in most states, because a large share of HIC registrations are one person trading as an LLC, and knowing the name on the credential is the difference between “Dear Sir or Madam” and asking for someone by name at the counter. city and zip_code are your branch-catchment split. Note what is not in that row: no street address, no phone, no email.

What you’d do with it

Export to CSV, import keyed on credential_number, then match business_name against your own account list. The ones that match are existing customers who should be enrolled on their next visit; the ones that do not are the prospect list. Sort that list by expiration_date and work it in renewal order, because a contractor thinking about their registration is a contractor thinking about the coming season’s work. Re-run it quarterly against the same key: rows that appeared since last time are your welcome-pack list, rows that vanished are churn you should stop mailing.

Worth knowing

No contact details. The DCP dataset gives you city, state and ZIP — and nothing else. There is no street address, no phone number and no email in these records. If your campaign needs any of those, that is an enrichment step you own; this list gets you names, credentials and geography.

County is derived, not published. It comes from a static CT ZIP-to-county map covering the state’s major ZIPs. Contractors with an out-of-state address or an uncommon ZIP come back with county: null and will never match a county filter — so a Hartford County run is “everyone whose registered ZIP we can place in Hartford County”, not a guarantee of everyone who works there.

Home Improvement Contractors only. This is one DCP credential type. Electricians, plumbers, home inspectors and new-home construction contractors are licensed under other DCP programmes that are not in this dataset. A HIC registration is also not a trade licence — it does not tell you the holder is qualified to do electrical or plumbing work.

It is a snapshot, not a live registry. The open-data export lags the registry by a business day or two, so a credential revoked this morning can still read Active in today’s run.

Statewide, all-status pulls are big. Dropping the county filter and setting statusFilter to ALL means paging 130,000+ rows, which will run past the actor’s default run timeout. If you want the whole state, raise the timeout deliberately rather than discovering it at row 90,000.


Run it yourself: How to run Connecticut Contractor Directory & Leads Scraper (DCP) walks the whole thing step by step.

When one name is all you need: Check a Connecticut Home Improvement Contractor verifies a single registration when a contractor is already in front of you and the question is just “is this real?”. And if your programme runs across state lines, Multi-State Contractor & Trade License Lookup checks the same contractor against CT, WA, OR and TX from one input.

Last updated 2026-07-22