Washington L&I Contractor & Tradesperson License Scraper avatar

Washington L&I Contractor & Tradesperson License Scraper

Pricing

from $0.49 / 1,000 results

Go to Apify Store
Washington L&I Contractor & Tradesperson License Scraper

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

Dataspryva

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

3 days ago

Last modified

Features

Limited permissions

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 maxItems or 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 number
  • ubi — Washington Unified Business Identifier, when on file
  • businessName — business or individual licensee name
  • contractorType / licenseType — e.g. Electrician, Asbestos Worker, General/Specialty Contractor
  • contractorGroup — top-level category (e.g. Electrical, Plumber, Asbestos)
  • asbestosGroup — asbestos-program sub-classification, when the license is asbestos-related
  • status — Active, Inactive, Expired, Suspended, Out of Business, Re-Licensed, Superseded, or Retest
  • statusDescription — the raw L&I status text (e.g. EXPIRED, ACTIVE, SUPERCEDED) — detail mode only
  • employerDisplayStatus — L&I's workers'-comp employer-account display status, when on file
  • city, state, zipCode, county, address1, address2, phoneNumber — detail mode only for address/phone
  • businessType — e.g. Limited Liability Company, Individual, Corporation
  • parentCompany — parent/umbrella business, when on file
  • effectiveDate, expirationDate, suspendDate — ISO YYYY-MM-DD
  • specialtyCode1, specialtyName1, specialtyText1 and specialtyCode2/specialtyName2/specialtyText2 — construction contractor specialty classification
  • contractorTypeDescription — plain-language description of the license type
  • licenseTypeCode — L&I's internal short code for the license type (e.g. CC) — detail mode only
  • relationType — the licensee's relation type on the record (e.g. Business, Individual) — detail mode only
  • hasSafetyViolation, hasContractorViolation — boolean flags
  • hasInactiveWorkersCompAccounts — boolean
  • associatedLicenses[] — other licenses/registrations tied to the same business or person
  • businessOwners[] — owners/officers/partners, with role and start/end dates
  • bonds[] — surety bond company, account number, amount, effective/expiration dates
  • insurances[] — liability insurance firm, account ID, amount, effective/expiration dates
  • savingsAccounts[] — savings account assignment in lieu of bond, when on file
  • violations[], summons[], warrants[], debarments[], strikes[] — enforcement history, when on file
  • lapses[] — license lapse/reinstatement history
  • courses[], affidavits[], codes[] — continuing education and compliance records, when on file
  • doshInspections[] — Washington DOSH workplace safety inspection history, when on file
  • workersCompAccounts[] — workers'-comp account(s) on file: accountId, legalName, dbaName, isCurrent, balanceCode, balanceMessage, estimatedWorkers, representative, and riskClasses[] (class code, description, rate, effective date)
  • hasActiveWorkersCompAccount — true when at least one linked workers'-comp account is current
  • governingPersons[] — business governing persons on file
  • employerBusinessDetails — workers'-comp employer business record (legal name, business ID, address), when on file
  • contractorTrackingUrl, contractorRegistrationUrl — related L&I portal links
  • sourceUrl — 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

FieldTypeDefaultDescription
modestringbyNamebyName / byLicenseId / byUbi / byAccountId
namestringsmithBusiness name or individual last name (mode=byName); min 2 characters
licenseIdstring–License/registration/certificate number, exact or prefix (mode=byLicenseId)
ubistring–9-digit Washington UBI number (mode=byUbi)
accountIdstring–Workers' comp account ID, e.g. 88160900 (mode=byAccountId); formatted values like 881,609-00 are normalized
citystring–Restrict results to a single Washington city (case-insensitive, applied server-side by L&I and re-checked client-side)
zipCodestring–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)
licenseCategorystring–Restrict results to one of 20 license categories (applied server-side by L&I)
statusFilterstring–active / inactive / expired / suspended / out of business / re-licensed / superseded / retest
violationsOnlybooleanfalseOnly emit records with a safety and/or contractor violation flagged
sortBystringrelevancerelevance (L&I best match) / name (business name)
sortOrderstringdescdesc / asc, applied to sortBy
fetchDetailsbooleantrueEnrich each result with the full detail record (bonds, insurance, owners, violations, workers'-comp accounts, etc.)
maxItemsinteger10Hard 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 (maxItems ceiling). 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 matches in 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 violationsOnly are 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 fetchDetails to false.

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.