Massachusetts Construction Supervisor License Lookup (CSL)

Massachusetts Construction Supervisor License Lookup checks Massachusetts CSL records by license number or last name on the state's public DOL/OPSI license verification site and returns license number, licensee name, license type, status, issue, renewal and expiration dates, business name and city, state and ZIP. It is built for general contractors, building departments, insurers, property managers and homeowners who verify construction supervisors in bulk, and it costs USD 10 per 1,000 CSL records on the FREE tier (USD 8 on GOLD).

What does the Massachusetts CSL lookup return?

Each dataset row is one Construction Supervisor License record:

Field	What it contains
licenseNumber	CSL number as the state lists it, for example CS-067262
licenseeName	Licensee name from the state result or detail page
licenseType	Construction Supervisor, Construction Supervisor 1 & 2 Family or Construction Supervisor Specialty
licenseStatus	State status label as shown, for example Active, Expired or Null and Void
profession, secondaryLicenseType	Profession group (for example Building Licenses) and any subtype the detail page shows
issueDate, lastRenewalDate, expirationDate	Dates from the detail page, as YYYY-MM-DD
doingBusinessAs	Business name when the detail page lists one
city, stateCode, zipCode	License-address city, state and ZIP; street address and gender are left out
detailAvailable	true when the detail page was read
searchMode, matchedQuery	How the record was found
state, sourceName, sourceUrl, checkedAt	MA, the state source and the check time

Run diagnostics are saved as SUMMARY in the key-value store: outcome (DATA, EMPTY, PARTIAL, BLOCKED, REJECTED or FAILED), records returned, searches and pages, source requests and warnings.

How do I verify a Massachusetts construction supervisor license by number?

Put up to 10 CSL numbers in queries with searchMode set to licenseNumber. The Actor searches each CSL type in turn and stops as soon as it finds the exact number, so a full number usually costs one record.

{
  "queries": ["CS-067262"],
  "searchMode": "licenseNumber",
  "licenseType": "any",
  "licenseStatus": "any",
  "maxResults": 20,
  "includeDetails": true
}

License numbers can contain letters, digits, spaces, periods, hyphens, slashes and a leading * wildcard. Partial numbers return every match up to maxResults.

How do I look up construction supervisors by last name?

Set searchMode to lastName and enter surnames. A common name matches many licensees, so narrow it with licenseType and licenseStatus and cap it with maxResults (1 to 50, default 20).

{
  "queries": ["Smith"],
  "searchMode": "lastName",
  "licenseType": "unrestricted",
  "licenseStatus": "Active",
  "maxResults": 10,
  "includeDetails": false
}

licenseType accepts any, unrestricted, oneTwoFamily or specialty. licenseStatus accepts any or one of the 28 state statuses in the input list, such as Active, Expired, Inactive, Revoked or Suspended. With includeDetails off, the run is faster but returns only number, name, type and status; dates and location stay null.

Is a CSL the same as a Massachusetts contractor license?

No. Massachusetts has two separate credentials. The Construction Supervisor License (CSL) is issued to individuals who supervise building construction, in three types: unrestricted, 1 & 2 Family dwellings, and Specialty trades. Home Improvement Contractor (HIC) registration covers contractors doing home-improvement work on existing homes. This Actor checks CSL records only; it does not check HIC registrations, electrical, plumbing or other trade licenses.

When should I use it, and when not?

Use it when you need to verify Massachusetts construction supervisors: checking a subcontractor list before a job, confirming the supervisor named on a building permit, re-checking expiration dates every month, or screening licensees for insurance or lending.

Use something else when:

• You need contractor licenses in other states: Contractor License Leads, Connecticut Contractor Directory & Leads Scraper, Michigan Contractor License Lookup or North Carolina Contractor License Lookup.
• You need building permits with contractor names: Building Permits Scraper.
• You need HIC registrations or a certified verification letter: use the state's own services.

How do I run it from code?

JavaScript with apify-client:

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('muhammadafzal/massachusetts-construction-license-lookup').call({
    queries: ['CS-067262'],
    searchMode: 'licenseNumber',
    includeDetails: true,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
for (const l of items) console.log(l.licenseNumber, l.licenseStatus, l.expirationDate);

Python with apify-client:

import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("muhammadafzal/massachusetts-construction-license-lookup").call(run_input={
    "queries": ["CS-067262"],
    "searchMode": "licenseNumber",
    "includeDetails": True,
})
for l in client.dataset(run.default_dataset_id).iterate_items():
    print(l["licenseNumber"], l["licenseType"], l["licenseStatus"], l.get("expirationDate"))

Use it from an AI assistant

Massachusetts Construction Supervisor License Lookup works from Claude, ChatGPT, Cursor or any MCP client through Apify's MCP server. Add the single-tool URL https://mcp.apify.com/?tools=muhammadafzal/massachusetts-construction-license-lookup to your client and ask, for example: "Check whether Massachusetts construction supervisor license CS-067262 is active and when it expires." Each record is charged at the prices below.

What does the output look like?

The record from the default input in a 2026-10-26 cloud run (personal and business names masked here):

{
  "state": "MA",
  "licenseNumber": "CS-067262",
  "licenseeName": "K***** T S**** JR",
  "licenseType": "Construction Supervisor",
  "licenseStatus": "Active",
  "profession": "Building Licenses",
  "secondaryLicenseType": null,
  "issueDate": "2010-03-19",
  "lastRenewalDate": "2026-03-02",
  "expirationDate": "2028-03-19",
  "doingBusinessAs": "KT S**** Company",
  "city": "S NATICK",
  "stateCode": "MA",
  "zipCode": "01760",
  "detailAvailable": true,
  "searchMode": "licenseNumber",
  "matchedQuery": "CS-067262",
  "sourceName": "Massachusetts DOL/OPSI License Verification Site",
  "sourceUrl": "https://madpl.mylicense.com/Verification/Search.aspx?Facility=N",
  "checkedAt": "2026-10-26T07:40:43.873Z"
}

How much does a Massachusetts CSL lookup cost?

The Actor uses pay-per-event pricing, and platform usage is included in the event prices. Each CSL record saved to the dataset is one charged event; empty searches and rejected input charge no record events.

Event	FREE	BRONZE	SILVER	GOLD	PLATINUM / DIAMOND
Verified CSL record	USD 0.01	USD 0.00975	USD 0.0095	USD 0.008	USD 0.008
Actor start (per started GB of allocated memory)	USD 0.00625	USD 0.006094	USD 0.005938	USD 0.005	USD 0.005

Worked totals on the FREE tier at the default 256 MB memory (one start event):

• One license check (the default input): 1 × USD 0.01 + USD 0.00625 = USD 0.01625
• 50 records (the per-run maximum): 50 × USD 0.01 + USD 0.00625 = USD 0.50625

Limits and reliability

• Speed: 2026 cloud runs took 3 to 14 seconds for one license with details, and 9 seconds for 50 last-name records without details.
• Gentle access: one request at a time with a pause between requests, up to 3 result pages per search, at most 240 source requests and a 4-minute safety deadline per run.
• Honest outcomes: if the state site denies or rate-limits requests, the run reports BLOCKED or PARTIAL and keeps the records already found. A failed detail page keeps the listing fields and sets detailAvailable to false. A valid search with no match ends EMPTY.
• Source: the public Massachusetts DOL/OPSI verification site, with no login. Results are informational snapshots, not certified verification letters.

FAQ

How do I check if a Massachusetts construction supervisor license is valid?

Run the Actor with the CSL number in queries. licenseStatus shows the state status and expirationDate shows when the license lapses.

Can I check many CSL numbers at once?

Yes. Enter up to 10 numbers or names per run, and schedule repeated runs for longer lists.

Does it check Home Improvement Contractor (HIC) registrations?

No. It covers Construction Supervisor Licenses only.

Why is a date field null?

Dates, business name and location come from the detail page. They are null when includeDetails is off or the detail page could not be read (detailAvailable is false).

How often should I re-verify a license?

Before each contract or permit, and on a schedule for active subcontractors. Licenses can expire or be suspended between checks.

Is this an official verification?

No. It reads the same public state site you can search by hand. For legal or permit decisions, confirm with the Division of Occupational Licensure.

Related Actors

• Contractor License Leads: licensed US contractors with status, trade and contact data
• Connecticut Contractor Directory & Leads Scraper: Connecticut contractor licenses
• Michigan Contractor License Lookup: Michigan builder and contractor licenses
• North Carolina Contractor License Lookup: North Carolina contractor licenses and qualifiers
• Building Permits Scraper: public building permits with contractor details

Legal and compliance

The Actor reads the public Massachusetts DOL/OPSI license verification site without logging in and does not bypass CAPTCHAs or access controls. Licensee names identify individuals: use the data for license verification and lawful business purposes, do not treat a matching name as identity proof, and follow CAN-SPAM, TCPA and Do Not Call rules for any outreach. This tool is not affiliated with the Commonwealth of Massachusetts, and this is not legal advice.

Last verified: 2026-10-26