Washington L&I Contractor & Tradesperson License Scraper
Pricing
from $0.49 / 1,000 results
Washington L&I Contractor & Tradesperson License Scraper
Search Washington L&I contractor, electrician, plumber, and asbestos-worker licenses by name, license number, UBI, or workers' comp account ID. Optional detail enrichment with bonds, insurance, violations. No login required.
Pricing
from $0.49 / 1,000 results
Rating
0.0
(0)
Developer
Dataspryva
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
3 days ago
Last modified
Categories
Features
Share
Scrape Washington State Department of Labor & Industries (L&I) contractor, electrician, plumber, elevator, and asbestos-worker license records from the official "Verify a Contractor, Tradesperson or Business" public registry. Search by business/individual name, license or registration number, UBI (Unified Business Identifier), or workers' comp account ID. Optionally enrich every result with the full license detail record — address, surety bonds, liability insurance, business owners, associated licenses, and safety/contractor violations. No login, no API key, no proxy required.
What this actor does
- Four search modes: by name, by license/registration/certificate number, by UBI number, by workers' comp account ID
- 20 license categories covered: general/specialty construction contractors, electrical (contractor, administrator, electrician, master electrician, trainee), plumbing (contractor, plumber, plumber trainee, medical gas), asbestos (contractor, supervisor, worker), elevator (contractor, mechanic, primary contact), and manufactured home installers
- Pagination: fetches 100 results per request and keeps paging until
maxItemsor the result set is exhausted (up to 500 emitted records per run) - Filters: license category, license status, city, zip code, and violations-only — category, active status, city and zip are applied by L&I server-side as well as re-checked client-side
- Sort: L&I relevance or business name, ascending or descending
- Optional detail enrichment: attach full business detail — surety bonds, liability insurance, business owners/officers, associated licenses, workers'-comp accounts, safety and license violations, DOSH inspections
- Backward compatible: input keys from older saved tasks (
query,maxResults,includeDetails, …) are mapped in code, so existing tasks keep running - Empty fields are omitted — every record only contains data L&I actually returned for that license
Data source
This actor reads Washington State L&I's own public "Verify a Contractor, Tradesperson or Business" lookup tool — the same results the official website's search page shows. No login, API key, or proxy is required.
Output per license record
licenseId— the L&I license, registration, or certificate numberubi— Washington Unified Business Identifier, when on filebusinessName— business or individual licensee namecontractorType/licenseType— e.g.Electrician,Asbestos Worker,General/Specialty ContractorcontractorGroup— top-level category (e.g.Electrical,Plumber,Asbestos)asbestosGroup— asbestos-program sub-classification, when the license is asbestos-relatedstatus—Active,Inactive,Expired,Suspended,Out of Business,Re-Licensed,Superseded, orReteststatusDescription— the raw L&I status text (e.g.EXPIRED,ACTIVE,SUPERCEDED) — detail mode onlyemployerDisplayStatus— L&I's workers'-comp employer-account display status, when on filecity,state,zipCode,county,address1,address2,phoneNumber— detail mode only for address/phonebusinessType— e.g.Limited Liability Company,Individual,CorporationparentCompany— parent/umbrella business, when on fileeffectiveDate,expirationDate,suspendDate— ISOYYYY-MM-DDspecialtyCode1,specialtyName1,specialtyText1andspecialtyCode2/specialtyName2/specialtyText2— construction contractor specialty classificationcontractorTypeDescription— plain-language description of the license typelicenseTypeCode— L&I's internal short code for the license type (e.g.CC) — detail mode onlyrelationType— the licensee's relation type on the record (e.g.Business,Individual) — detail mode onlyhasSafetyViolation,hasContractorViolation— boolean flagshasInactiveWorkersCompAccounts— booleanassociatedLicenses[]— other licenses/registrations tied to the same business or personbusinessOwners[]— owners/officers/partners, with role and start/end datesbonds[]— surety bond company, account number, amount, effective/expiration datesinsurances[]— liability insurance firm, account ID, amount, effective/expiration datessavingsAccounts[]— savings account assignment in lieu of bond, when on fileviolations[],summons[],warrants[],debarments[],strikes[]— enforcement history, when on filelapses[]— license lapse/reinstatement historycourses[],affidavits[],codes[]— continuing education and compliance records, when on filedoshInspections[]— Washington DOSH workplace safety inspection history, when on fileworkersCompAccounts[]— workers'-comp account(s) on file:accountId,legalName,dbaName,isCurrent,balanceCode,balanceMessage,estimatedWorkers,representative, andriskClasses[](class code, description, rate, effective date)hasActiveWorkersCompAccount—truewhen at least one linked workers'-comp account is currentgoverningPersons[]— business governing persons on fileemployerBusinessDetails— workers'-comp employer business record (legal name, business ID, address), when on filecontractorTrackingUrl,contractorRegistrationUrl— related L&I portal linkssourceUrl— canonical L&I Verify detail page URL for the license (includes the UBI for business licenses so L&I shows the full workers'-comp record)recordType: "license",scrapedAt
Input
| Field | Type | Default | Description |
|---|---|---|---|
mode | string | byName | byName / byLicenseId / byUbi / byAccountId |
name | string | smith | Business name or individual last name (mode=byName); min 2 characters |
licenseId | string | – | License/registration/certificate number, exact or prefix (mode=byLicenseId) |
ubi | string | – | 9-digit Washington UBI number (mode=byUbi) |
accountId | string | – | Workers' comp account ID, e.g. 88160900 (mode=byAccountId); formatted values like 881,609-00 are normalized |
city | string | – | Restrict results to a single Washington city (case-insensitive, applied server-side by L&I and re-checked client-side) |
zipCode | string | – | Restrict results to a single 5-digit Washington zip code (applied server-side by L&I and re-checked client-side; ignored if city is also set) |
licenseCategory | string | – | Restrict results to one of 20 license categories (applied server-side by L&I) |
statusFilter | string | – | active / inactive / expired / suspended / out of business / re-licensed / superseded / retest |
violationsOnly | boolean | false | Only emit records with a safety and/or contractor violation flagged |
sortBy | string | relevance | relevance (L&I best match) / name (business name) |
sortOrder | string | desc | desc / asc, applied to sortBy |
fetchDetails | boolean | true | Enrich each result with the full detail record (bonds, insurance, owners, violations, workers'-comp accounts, etc.) |
maxItems | integer | 10 | Hard cap on emitted license records (1–500) |
Example: search by business name with detail enrichment
{"mode": "byName","name": "smith","fetchDetails": true,"maxItems": 20}
Example: look up an exact license number
{"mode": "byLicenseId","licenseId": "ABCAR**824BB","fetchDetails": true}
Example: search by UBI number, active licenses only
{"mode": "byUbi","ubi": "604164913","statusFilter": "active"}
Example: browse all licensed electricians without detail hydration (faster)
{"mode": "byName","name": "construction","licenseCategory": "Electrician","fetchDetails": false,"maxItems": 100}
Example: search by name restricted to one city
{"mode": "byName","name": "construction","city": "Spokane","maxItems": 25}
Example: compliance check for licenses with flagged violations
{"mode": "byName","name": "construction","violationsOnly": true,"maxItems": 25}
Use cases
- Due diligence — verify a contractor's license, bond, and insurance status before hiring
- Compliance monitoring — track license status and violation history for vendors and subcontractors
- Lead generation — build lists of licensed contractors/tradespeople by category or region
- Insurance & surety underwriting — cross-check bond and insurance coverage on file with L&I
- Legal & background research — pull violation, debarment, and lapse history tied to a business or UBI
Limitations
- 500 records per run (
maxItemsceiling). L&I's search API returns at most 100 rows per page and has no cursor/export endpoint, so very broad queries are split by licence category, location or name prefix. - Scan ceiling: to satisfy client-side filters (non-active statuses, violations-only), the actor scans up to 5,000 search matches per run. If a filter matches only records beyond that point, the run reports
scanned N of M matchesin its status message instead of pretending it saw everything. - Server-side filter scope: category, active status, city and zip code are applied by L&I; other statuses and
violationsOnlyare checked over the scanned rows. - Violation-only search rows (a violation with no licence number) are not part of this licence dataset; they carry no licence record to enrich. Search by the business name or UBI to reach the related licence instead.
- Detail enrichment is one request per record. For large runs without bonds/insurance/workers'-comp data, set
fetchDetailstofalse.
FAQ
Do my existing saved tasks keep working?
Yes. Older input keys such as query/searchQuery, maxResults, includeDetails, licenseNumber, ubiNumber, accountNumber and category are mapped to the current fields in code. The legacy statusFilter: "archived" value is still honoured too.
How many results can one run return?
Up to 500 (maxItems). The actor pages 100 rows at a time and stops at maxItems, when L&I has no more matches, or at the 5,000-row scan ceiling. The run's status message states how many matches were scanned.
What is the data source?
This actor uses Washington State Department of Labor & Industries' own public "Verify a Contractor, Tradesperson or Business" lookup tool at secure.lni.wa.gov/verify. It is a genuine public REST API with no authentication requirement — the same data the L&I website itself displays.
Is this affiliated with Washington State L&I? No. This is an independent, third-party actor that reads L&I's public verification data. It is not affiliated with or endorsed by the Washington State Department of Labor & Industries.
Why does fetchDetails matter?
Search results alone give you the license number, business name, category, and basic status. Turning on fetchDetails (the default) fetches the full record for each result — address, bonds, insurance, business owners, and violation history — at the cost of one extra request per record. Turn it off for faster, lighter-weight bulk name/category browsing.
Why are some fields missing on certain licenses? L&I only returns the fields it has on file for a given license. Bonds, insurance, and violation history are commonly empty for license types that don't require them (e.g. individual trade certifications like Electrician or Asbestos Worker don't carry bond/insurance records the way business contractor licenses do). Empty fields are always omitted rather than shown as blank or null.
What's the difference between "Construction Contractor" and the electrical/plumbing/asbestos/elevator categories? "Construction Contractor" is L&I's general contractor and specialty-trade contractor registration (bonded businesses). Electrical, plumbing, asbestos, and elevator categories are separate certification/licensing programs for individual tradespeople and specialty contractors in those disciplines, each with their own bonding/insurance rules.
How fresh is the data? Every run queries the live L&I API directly — there is no caching layer, so results reflect L&I's registry at the moment the actor runs.
Can I narrow results to a specific city or zip code?
Yes. Set city (e.g. Seattle) or zipCode (e.g. 98121) alongside any search mode — L&I's own registry applies the location filter server-side on top of your name/license/UBI/account search, the same as the location dropdown on the official Verify tool's results page. If both are set, city takes priority.
Can I search by partial name?
Yes. name (mode=byName) and licenseId (mode=byLicenseId) both support partial/prefix matching, mirroring L&I's own search behavior — the same as typing into the site's search box.
Does this include Washington's professional licenses (real estate, cosmetology, etc.)? No — those are handled by a different Washington State agency (the Department of Licensing, DOL) with a separate lookup tool. This actor is scoped to L&I's contractor, tradesperson, and workers'-comp registry only.