Massachusetts Construction License Lookup & Verify (CSL)

Look up Massachusetts Construction Supervisor License (CSL) records by license number or surname using the public Massachusetts DOL/OPSI verification site. The Actor returns the state-listed license type, status, dates, and selected non-street location fields in a structured dataset.

Results are informational snapshots from the public verification site. They are not a certified verification letter or a legal determination. Confirm time-sensitive decisions with the state source.

What the Actor returns

Field	Description
licenseNumber	Massachusetts CSL number from the state result
licenseeName	Licensee name displayed by the source
licenseType	Construction Supervisor, 1 & 2 Family, or Specialty
licenseStatus	State status label, preserved as shown
issueDate, lastRenewalDate, expirationDate	Detail-page dates normalized to YYYY-MM-DD
secondaryLicenseType	Additional subtype when the state page provides it
doingBusinessAs	Business name when the detail page provides it
city, stateCode, zipCode	Limited license-address location fields; street address and gender are omitted
detailAvailable	Whether the detail page was read successfully
matchedQuery, searchMode	The input that returned the license
sourceUrl, checkedAt	Source search page and UTC retrieval time

Run diagnostics and warnings are written to the key-value store record SUMMARY. License records remain the only rows in the default dataset.

Search inputs

Use queries with one to ten values. Set searchMode to licenseNumber or lastName. Full license numbers usually give the narrowest result. A last name can match many records, so set maxResults to control output and charges.

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

To search by surname:

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

licenseType supports any, unrestricted, oneTwoFamily, and specialty. licenseStatus can be any or a status available in the state form. Search is limited to Massachusetts CSL records; it does not check Home Improvement Contractor registrations or other trades. Free-plan users receive at most five result records per run. Paid-plan runs can return the configured maximum, up to 50.

Output example

{
  "state": "MA",
  "licenseNumber": "CS-123456",
  "licenseeName": "Example Licensee",
  "licenseType": "Construction Supervisor",
  "licenseStatus": "Active",
  "profession": "Building Licenses",
  "secondaryLicenseType": null,
  "issueDate": "2020-04-15",
  "lastRenewalDate": null,
  "expirationDate": "2028-04-15",
  "doingBusinessAs": null,
  "city": "Boston",
  "stateCode": "MA",
  "zipCode": "02108",
  "detailAvailable": true,
  "searchMode": "licenseNumber",
  "matchedQuery": "CS-123456",
  "sourceName": "Massachusetts DOL/OPSI License Verification Site",
  "sourceUrl": "https://madpl.mylicense.com/Verification/Search.aspx?Facility=N",
  "checkedAt": "2026-09-24T00:00:00.000Z"
}

Pricing

The Actor uses Pay per event pricing: a start event plus the automatic apify-default-dataset-item event for each valid dataset record. The Actor does not manually charge synthetic events. Live prices must be verified in Apify before billable runs.

Tier	Start event	Per CSL record	One-result example
FREE	$0.006250	$0.010000	$0.016250
BRONZE	$0.006094	$0.009750	$0.015844
SILVER	$0.005938	$0.009500	$0.015438
GOLD	$0.005000	$0.008000	$0.013000
PLATINUM / DIAMOND	$0.005000	$0.008000	$0.013000

The prices are set to keep the start event at or above $0.005 across the listed tiers and to include routine direct-source traffic. One result is the minimum useful paid run; a 20-record run costs 20 record events plus one start event. The Actor uses no proxy or external paid API. These are initial prices and should be rechecked against settled cloud usage before publication.

Reliability and limits

The Actor submits the site's public search form with one sequential request path, follows at most three result pages per search, retries transient errors a bounded number of times, and stops on an access denial or rate limit. It does not bypass sign-in, CAPTCHA, paywalls, or access controls. If the state site denies the request, the run summary reports BLOCKED or PARTIAL; the Actor does not invent records.

When includeDetails is true, the Actor reads the linked detail pages for dates and limited location fields. A failed detail request keeps the valid listing fields and marks detailAvailable false. A valid no-match response produces an empty dataset with an EMPTY summary. Dataset item billing is handled automatically by Apify when the live synthetic event is enabled; no result is billed when no record is written.

Source and use

The Massachusetts Division of Occupational Licensure directs users to public license-check portals for CSL verification. The DOL/OPSI license site says its search can verify license status and download search results. The state also offers a separate professional licensing API for approved vendors and municipalities; that API requires an issued key, so this Actor does not call it.

Use the data for routine license screening and follow-up. Do not treat a matching name as identity proof. Recheck the state source before signing contracts, issuing permits, or making other consequential decisions.