Massachusetts Construction License Lookup & Verify (CSL)

Pain points

• Verifying a Massachusetts Construction Supervisor License means one slow manual lookup at a time on a clunky state portal.
• The MyLicense portal isn't built for compliance workflows, vetting pipelines, or CRM enrichment.
• Checking status and expiration across many licensees by hand doesn't scale for hiring or underwriting teams.

What we solve

• Verify any MA Construction Supervisor License by license number or last name — one search.
• Returns license type, status, expiration, and address from the official state registry.
• Enrich a license number or name into a full structured record; pay per match, empty searches free.

Summary

Look up and verify any Massachusetts Construction Supervisor License from a single search — type a license number (e.g. CS-093362) or a last name and get back the license type, status, expiration, and address, straight from the Commonwealth's official MyLicense registry (Office of Public Safety and Inspections). Covers all three CSL subtypes: Construction Supervisor, 1 & 2 Family, and Specialty. Each match is optionally enriched with its full detail record. Built for fast verification, compliance checks, and enriching a license number or name into a structured record.

Who it's for

• GCs and hiring managers vetting Massachusetts subcontractors
• Insurance underwriters and lenders running KYC on contractors
• Compliance teams and marketplaces verifying CSL licenses
• RevOps and BD teams enriching contractor records

How to use

Set the input, run the actor, and collect results from the run's dataset (export to JSON/CSV/Excel, or pull via the Apify API). Example input:

{
  "query": "Smith",
  "licenseType": "",
  "includeDetails": true,
  "maxResults": 40
}

See Inputs below for every available field.

What you get

One row per record:

Field	Description
state	Always 'MA' for this actor
license_number	MA Construction Supervisor License number (e.g. CS-093362)
person_name	Individual licensee full name
business_name	Doing-business-as name, when on file (detail)
license_type	Construction Supervisor, 1 & 2 Family, or Specialty
status	License status (e.g. Active, Expired, Null and Void, Suspended)
issue_date	Original licensure date (detail)
expiration_date	License expiration date (detail)
city	Licensee city (detail)
address	Street address (detail)
zip_code	ZIP code (detail)
matched_by	Which search surfaced this match: license_number or last_name
source_url	Link to the official MyLicense record

Sample:

{
  "state": "MA",
  "license_number": "CS-093362",
  "person_name": "CHARLES JOHNSON IV",
  "business_name": null,
  "license_type": "Construction Supervisor",
  "status": "Null and Void",
  "issue_date": "2/9/2010",
  "expiration_date": "2/9/2014",
  "city": "Salisbury",
  "address": "17 LENA MAES WAY",
  "zip_code": "01952",
  "matched_by": "license_number",
  "source_url": "https://madpl.mylicense.com/Verification/Details.aspx?result=e42cc6bc-9d25-4fa1-a73b-656980e54be9"
}

Inputs

Field	Required	Type	Default	Description
query	yes	string	"Smith"	A Massachusetts Construction Supervisor License number (e.g. 'CS-093362' or just the digits) OR a last name. A license number is looked up directly; anything else is searched against the last-name index. Both return the matching licenses, deduped by license number.
licenseType	no	string	""	Restrict the search to one Construction Supervisor License subtype. Default searches all three.
statusFilter	no	string	—	Exact license-status text to keep, e.g. 'Active', 'Expired', 'Null and Void', 'Suspended', 'Revoked'. Default: no filter (all statuses).
includeDetails	no	boolean	true	When on (default), each match is enriched with its full Details.aspx record — address, city, ZIP, and issue/expiration dates. Turn off for a faster, lighter result list (name, license #, type, status).
maxResults	no	integer	50	Cap on the number of matches returned (and enriched) in a single run. The portal itself caps each individual search at ~40 rows per page — narrow the query (name, license type, status) to get under that. Default 50.
proxyConfiguration	no	object	{"useApifyProxy": false}	Optional. The MyLicense portal is usually reachable directly; enable a proxy (e.g. residential) only if a run is blocked or served a challenge.

Pricing (Pay Per Event)

You pay per result (dataset-item) — no charge for empty runs. Example: 100 verified license records at $0.004/result ≈ $0.40.

Illustrative — the final per-result price is set at publish time. Apify platform usage (compute) is billed separately per your plan.

Use cases

• License verification — confirm a MA Construction Supervisor's license type, status, and expiration before hiring or onboarding.
• Record enrichment — turn a license number or name into a full structured record for a CRM, marketplace, or vetting workflow.
• Compliance checks — pull authoritative state registry data on demand for audits and due diligence.
• Lender / insurer due diligence — verify a contractor's standing straight from the state registry.

Why this actor

• Straight from the official Massachusetts MyLicense registry — authoritative, not a stale third-party copy.
• Search by license number or last name; results deduped by license #.
• Pay per match; searches with no results are free.

Limitations & updates

Covers the Construction Supervisor License (CSL) only — Home Improvement Contractor (HIC) registration is a separate Salesforce portal and is out of scope. Each individual search (one license type at a time) is capped at ~40 results by the portal itself; narrow by license type, status, or name to stay under it. Phone, county, bond, and insurance fields are included in the schema for suite consistency but this registry does not publish them (returned null).

FAQ

Where does the data come from?

The official Massachusetts MyLicense 'Verification' registry (madpl.mylicense.com), run by the Office of Public Safety and Inspections — public, authoritative license data.

What can I search by?

A Construction Supervisor License number (e.g. CS-093362) or a last name. Both return the matching licenses, deduped by license number.

Does this cover Home Improvement Contractor (HIC) registration too?

No — HIC registration lives on a separate Salesforce portal (contractorhub.mass.gov) and isn't covered by this actor. This actor covers the Construction Supervisor License (CSL) only.

What fields do I get?

License number, licensee name, license type, status, and expiration, plus address and issue date when detail enrichment is on.

How am I charged?

Pay-per-result — per license match returned. No charge for searches with no results.

Is this personal data?

It's public professional-license data (licensee records as the Commonwealth publishes them); we add no personal/PII enrichment.

How current is it?

It reflects the live MyLicense record at lookup time.

Which actor to choose

Part of the contractor-license verification suite — pick the one that fits your goal:

• California Contractor License Lookup & Verify (CSLB) — You need a California contractor verified — by license number, business, or owner/personnel name (CSLB).
• Florida Contractor License Lookup & Verify (DBPR) — You're verifying a Florida contractor or tradesperson — type, status, expiration, county (DBPR).
• Louisiana Contractor License Lookup — You want the full Louisiana roster — 50,000+ commercial, residential & specialty licenses as data (LSLBC).
• Multi-State Contractor & Trade License Lookup — You don't know the state, or want the same contractor checked across WA, OR, TX & CT in one run.
• Nevada Contractor License Lookup & Verify (NSCB) — You need a Nevada contractor's status, trade classifications, bond & principals (NSCB).
• New Mexico Contractor License Lookup & Verify (NM CID) — You're verifying a New Mexico contractor — license #, status, city/ZIP, expiry (NM CID).
• North Carolina Contractor License Lookup & Verify (NCLBGC) — You're verifying a North Carolina general contractor — classification, status, expiration (NCLBGC).
• Oregon Contractor License Lookup & Verify (CCB) — You're verifying an Oregon contractor — status, bond, insurance & RMI (CCB).
• South Carolina Contractor License Lookup & Verify (SC LLR) — You're searching or verifying South Carolina contractors — by name, license, city, or classification (SC LLR).
• Tennessee Contractor License Lookup & Verify (TN DOCI) — You're verifying a Tennessee contractor or tradesperson — type, status, city & county (TN DOCI).
• Texas Contractor & Trade License Lookup (TDLR) — You're verifying a Texas electrician, HVAC or trade license — type, expiration, county & owner (TDLR).
• Virginia Contractor License Lookup (DPOR Bulk) — You want the full Virginia roster — 50,000+ Class A/B/C and trade licenses as bulk data (DPOR).
• Washington Contractor License Lookup & Verify (L&I) — You're verifying a Washington contractor — type, status, expiration, principal (L&I).
• Alabama Contractor License Lookup & Verify (LBGC) — You're verifying an Alabama general contractor — classification, city, phone, expiration (LBGC).
• Arkansas Contractor License Lookup & Verify (ACLB) — You're verifying an Arkansas contractor — validity, type, expiration, city & county (ACLB).
• Michigan Contractor License Lookup & Verify (LARA) — You're verifying a Michigan builder or trade contractor — type, status, expiration (LARA).
• Minnesota Contractor License Lookup & Verify (DLI) — You're verifying a Minnesota residential contractor — subtype, status, expiration, enforcement flags (DLI).