Virginia DPOR Professional License Scraper avatar

Virginia DPOR Professional License Scraper

Pricing

from $2.50 / 1,000 results

Go to Apify Store
Virginia DPOR Professional License Scraper

Virginia DPOR Professional License Scraper

Virginia DPOR license scraper & API: search Department of Professional and Occupational Regulation licenses and export license number, type, status, name, address and dates. Professional license verification and lead generation — fast, no login.

Pricing

from $2.50 / 1,000 results

Rating

0.0

(0)

Developer

Haketa

Haketa

Maintained by Community

Actor stats

0

Bookmarked

7

Total users

1

Monthly active users

10 days ago

Last modified

Features

Limited permissions

Share

Virginia DPOR License Scraper — Contractor, Tradesman & Skilled-Trades License Data 🏛️🛠️

Extract official Virginia contractor and tradesman license records at scale. This Virginia DPOR license scraper downloads and normalizes the official public regulant lists from the Virginia Department of Professional and Occupational Regulation (dpor.virginia.gov) — covering Class A, B, and C contractors, master and journeyman tradesmen (electrical, plumbing, HVAC, gas fitting), backflow workers, elevator mechanics, water-well providers, energy analysts, and fire-sprinkler inspectors. No login, no coding, no proxies required.

Apify Actor Live Updated Engine No Auth Coverage Scale

Export every record to JSON, CSV, Excel (XLSX), XML, or REST API in seconds.

🏗️ Built for construction B2B sales & lead-generation teams, general-contractor compliance & bid-verification desks, skilled-trades recruiters, commercial insurance underwriters, surety bonding teams, home-services platforms, and workforce researchers.


⚡ At a Glance

FeatureDetails
Data SourceVirginia Department of Professional and Occupational Regulation (DPOR) Regulant Lists
License Categories CoveredAll 10 DPOR Bulk Categories: Class A (2701), Class B (2705b), Class C (2705c), Tradesman Combined (2710), Residential Tradesman (2709), Backflow (2717), Elevator Mechanic (2718), Water Well (2719), Energy Analyst (2722), Fire Sprinkler (2723)
Core Fields ExtractedlicenseNumber, name, businessName, individualName, licenseType, licenseCode, classification, specialties[], status, issueDate, expirationDate, address, city, state, zipCode, email
Contact Data IncludedDirect Registrant Email Address (email, ~60–72% fill) + Full Street & Mailing Address (address, city, state, zipCode)
Specialty Code ParsingSplits multi-code columns into clean arrays (["CBC", "RBC", "H"], ["MELE", "MPLB"])
Status DerivationAutomatically derives Active vs. Expired by comparing expirationDate against run date
Scale & SpeedHigh-speed batched streaming (500 records/batch) — 1,000+ records in < 10 seconds, up to 100,000+ full roster extract (maxRecords: 0)
Deduplication100% deduplicated within each license code via licenseCode:licenseNumber

📑 Table of Contents


🔎 Why Scrape Virginia DPOR?

The Virginia Department of Professional and Occupational Regulation (DPOR) regulates the companies and skilled tradespeople who build and maintain Virginia's residential, commercial, and civil infrastructure. DPOR publishes its active and recently expired roster as bulk tab-delimited text files — a high-value B2B dataset containing tens of thousands of licensed contractors and tradesmen with business names, individual names, classifications, trade specialties, issue/expiration dates, mailing addresses, and direct email addresses.

Working with the raw DPOR files directly is painful:

  • Latin-1 character encoding: Ingesting raw DPOR .txt files as UTF-8 corrupts accented characters and company names.
  • Cryptic uppercase headers: Columns are named CERTIFICATE #, FIRST LINE ADDRESS, FIVE DIGIT ZIP CODE, and EMAILADDRESS.
  • No status column: Raw files do not state whether a license is active or expired; you must normalize dates (MM/DD/YYYY → YYYY-MM-DD) and compare expirationDate against today's date.
  • Split addresses & dirty ZIPs: Street lines, suite numbers, and PO Boxes are split across three columns, and 5-digit ZIP codes have -0000 suffixes appended (22827-0000).
  • Mashed specialty codes: Multiple contractor and tradesman specialty designations (CBC, RBC, MELE, JPLB) are packed into single strings.

This Virginia DPOR scraper eliminates every data-wrangling step: it downloads the selected regulant files over direct HTTPS, decodes Latin-1 cleanly, maps 60+ header aliases into a unified JSON schema, merges business/individual names and multi-line addresses, strips -0000 ZIP suffixes, splits specialty codes into an array, computes status (Active / Expired), and streams deduplicated records in high-speed batches.


✨ What This Virginia DPOR Scraper Does

  • ✅ All 10 Virginia DPOR Regulant Categories in One Actor — Class A Contractor (2701), Class B Contractor (2705b), Class C Contractor (2705c), Tradesman Combined (2710), Residential Tradesman (2709), Backflow Prevention Worker (2717), Certified Elevator Mechanic (2718), Certified Water Well Systems Provider (2719), Residential Building Energy Analyst (2722), and Automatic Fire Sprinkler Inspector (2723).
  • ✅ Direct Registrant Emails Included (email) — captures the registrant email address on file with DPOR (populated on ~60–72% of records), making it an immediate B2B lead-generation list.
  • ✅ Smart Multi-Category Sampling & Overflow Top-Up — leave licenseCodes empty ([]) to pull a balanced sample across all 10 license types; if smaller specialty categories have fewer records than their share when maxRecords: 1000+ is requested, the scraper automatically tops up from larger categories so your run always reaches the exact maxRecords target.
  • ✅ Active-Only or Full-Roster Filtering (statusFilter) — choose "active" to keep only currently valid licenses (expirationDate >= today) or "all" to include expired certificates for renewal/win-back campaigns.
  • ✅ High-Speed Batched Dataset Streaming — pushes records in batches of 500 with built-in licenseCode:licenseNumber deduplication, delivering 1,000+ records in under 10 seconds.
  • ✅ Unified Contractor + Individual Schema — populates businessName for contractor firms, individualName for tradesmen, and a merged name field on 100% of records so downstream CRM imports never break.

🎯 Use Cases

Team / IndustryHow Teams Use Virginia DPOR License Data
Construction Supply, Equipment & SaaS SalesBuild segmented outreach lists of active Class A (2701), Class B (2705b), and Class C (2705c) contractors by specialty (RBC residential, CBC commercial, RFC roofing, H highway) with direct email and address.
General Contractor Compliance & Sub-VettingVerify subcontractor license numbers, classifications, and expirationDate before bid award or payment release.
Skilled-Trades Recruiting & StaffingSource licensed Master and Journeyman Electricians (MELE/JELE), Plumbers (MPLB/JPLB), HVAC Techs (MHVA/JHVA), and Gas Fitters (MGFC/JGFC) across Virginia metros.
Commercial Insurance & Surety BondingVerify principal licensure at policy bind and renewal; target contractors whose licenses expire within 60–90 days.
Home-Services & Property ManagementVet licensed elevator mechanics (2718), fire sprinkler inspectors (2723), backflow prevention workers (2717), and water-well providers (2719).
M&A, Legal & Workforce AnalyticsMap licensed contractor density by county/ZIP, track multi-license holders, and analyze Virginia's construction labor supply.

📥 Input Configuration

All fields are optional. Default prefill (licenseCodes: ["2701"], maxRecords: 100) finishes in ~4 seconds.

FieldKeyTypeDefaultDescription
License TypeslicenseCodesarray<string>["2701"]DPOR license codes to extract (2701, 2705b, 2705c, 2710, 2709, 2717, 2718, 2719, 2722, 2723). Leave empty [] for a balanced multi-category sweep.
License StatusstatusFilterstring"all""active" keeps only currently valid licenses (expirationDate >= today); "all" returns Active + Expired.
Maximum RecordsmaxRecordsinteger100 (prefill 100)Total record cap across all selected categories. Set 0 for unlimited full extract (1,000 to 100,000+ supported).
Delay Between DownloadsrequestDelayinteger200Polite pause in milliseconds between downloading each category file (0–10000).
Proxy ConfigurationproxyConfigurationobject{ "useApifyProxy": false }Optional proxy settings. Direct connection works out of the box without proxy cost.

📤 Output Schema & Field Reference

Every record uses one consistent, flat JSON schema across both business contractors and individual tradesmen.

Sample Record 1 — Class A Contractor Firm (2701)

{
"licenseNumber": "2701030496",
"individualName": null,
"businessName": "FROEHLING & ROBERTSON INC",
"name": "FROEHLING & ROBERTSON INC",
"licenseType": "Class A Contractor",
"licenseCode": "2701",
"board": "27",
"occupation": "01",
"classification": "A",
"specialties": ["H"],
"status": "Active",
"issueDate": "1987-08-31",
"expirationDate": "2027-08-31",
"address": "3015 DUMBARTON RD",
"city": "RICHMOND",
"state": "VA",
"zipCode": "23228",
"country": null,
"email": "jclingenpeel@fandr.com",
"scrapedAt": "2026-11-10T05:00:00.000Z"
}

Sample Record 2 — Master Tradesman (2710)

{
"licenseNumber": "2710070965",
"individualName": "DERRICK S SHIFFLETT",
"businessName": null,
"name": "DERRICK S SHIFFLETT",
"licenseType": "Tradesman Combined",
"licenseCode": "2710",
"board": "27",
"occupation": "10",
"classification": "TRAD",
"specialties": ["MPLB"],
"status": "Active",
"issueDate": "2019-03-28",
"expirationDate": "2028-03-31",
"address": "567 MILL LN",
"city": "ELKTON",
"state": "VA",
"zipCode": "22827",
"country": null,
"email": "dshifflett@gwood.com",
"scrapedAt": "2026-11-10T05:00:00.000Z"
}

Emoji-Grouped Field Reference & Coverage

🪪 License Identity & Holder
FieldTypeCoverageDescription
licenseNumberstring🟢 High (100%)Official DPOR certificate / license number.
namestring🟢 High (100%)Primary display name (businessName for firms, individualName for individuals).
businessNamestring|null🟡 ConditionalCompany name — populated 100% on contractor classes (2701, 2705b, 2705c); null on individual tradesmen.
individualNamestring|null🟡 ConditionalPerson name — populated 100% on individual tradesmen (2710, 2709, 2717–2723); null on contractor firms.
licenseTypestring🟢 High (100%)Human-readable category name (e.g., "Class A Contractor", "Tradesman Combined").
licenseCodestring🟢 High (100%)DPOR regulant list code (2701, 2705b, 2705c, 2710, etc.).
🛠️ Classification, Specialties & Status
FieldTypeCoverageDescription
board / occupationstring🟢 High (100%)DPOR regulatory board (27) and occupation code.
classificationstring|null🟢 High (99%+)License rank (A, B, C for contractors; TRAD for tradesmen).
specialtiesarray<string>|null🟢 High (98%+)Parsed array of contractor or trade specialty codes (["CBC", "RBC"], ["MELE", "JPLB"]).
statusstring🟢 High (100%)Derived status: "Active" (expirationDate >= today), "Expired", or "Unknown".
issueDatestring|null🟢 High (99%+)Original certification date normalized to YYYY-MM-DD.
expirationDatestring|null🟢 High (100%)License expiration date normalized to YYYY-MM-DD.
📍 Contact & Location
FieldTypeCoverageDescription
emailstring|null🟢 High (~60–72%)Direct registrant email address on file with DPOR.
addressstring|null🟢 High (99.8%)Merged street line 1, street line 2, and PO Box.
citystring|null🟢 High (99.8%)Registrant city (uppercase, e.g., RICHMOND, VIRGINIA BEACH, ARLINGTON).
statestring|null🟢 High (99.8%)State abbreviation (predominantly VA, plus out-of-state licensed firms).
zipCodestring|null🟢 High (99.8%)Cleaned ZIP / ZIP+4 code (meaningless -0000 suffixes stripped).
countrystring|null🟡 ConditionalPopulated only for international registrants; null for US domestic records.
scrapedAtstring🟢 High (100%)ISO-8601 UTC extraction timestamp.

🔁 Pagination, Batch Streaming & 1,000+ Scale

Because Virginia DPOR publishes each license category as a complete bulk file, this actor streams and normalizes thousands of rows in seconds:

  • 1,000+ to 100,000+ Records on Demand: Set maxRecords: 1000, 5000, or 0 (unlimited) to extract as many records as you need. Class A (2701), Class B (2705b), Class C (2705c), and Tradesman Combined (2710) contain tens of thousands of records.
  • Batched Dataset Writes (500 rows/batch): Records are pushed in 500-item chunks rather than one by one, making 1,000+ record runs finish in 4–10 seconds.
  • Balanced Multi-Code Sampling with Overflow Top-Up: When licenseCodes is left empty ([]) and maxRecords is set (e.g., maxRecords: 1000), the actor samples evenly across all 10 license codes and automatically tops up any shortfall from larger categories so you always get the exact number of records requested.
  • Built-In Deduplication: Every record is deduplicated by licenseCode:licenseNumber (0% duplicates).

📚 License Code & Specialty Reference

All 10 Supported License Codes

CodeLicense TypeTypical HoldersContract Value / Scope
2701Class A ContractorLarge construction firmsUnlimited single-contract & annual value ($120K+ single / $750K+ annual)
2705bClass B ContractorMid-size construction firmsSingle contract $10K–$120K; annual $150K–$750K
2705cClass C ContractorSmall firms & sole proprietorsSingle contract $1K–$10K; annual up to $150K
2710Tradesman CombinedIndividual tradespeopleMaster & Journeyman Electricians, Plumbers, HVAC, Gas Fitters
2709Residential TradesmanIndividualsResidential-scoped trade registrations
2717Backflow Prevention Device WorkerIndividualsCertified cross-connection backflow testers
2718Certified Elevator MechanicIndividualsElevator and escalator installation, repair & inspection
2719Certified Water Well Systems ProviderIndividuals / firmsWater well drilling and pump installation
2722Residential Building Energy AnalystIndividualsResidential energy performance auditors & modelers
2723Automatic Fire Sprinkler InspectorIndividualsCertified fire sprinkler system inspectors

Tradesman Designation Codes (2710, 2709)

Master CodeJourneyman CodeTrade Specialty
MELEJELEElectrician
MPLBJPLBPlumber
MHVAJHVAHVAC (Heating, Ventilation & Air Conditioning)
MGFCJGFCGas Fitter — Contractor
MLPGJLPGLiquefied Petroleum Gas Fitter
MNGFJNGFNatural Gas Fitter

Contractor Specialty Codes (2701, 2705b, 2705c)

CodeSpecialty DescriptionCodeSpecialty Description
CBCCommercial Building ContractorRBCResidential Building Contractor
HHighway / Heavy ConstructionELEElectrical Contractor
PLBPlumbing ContractorHVAHVAC Contractor
GFCGas Fitting ContractorEMCElectronic / Mechanical Contractor
EECElevator / Escalator ContractorVCCVessel Construction Contractor
CICCommercial Improvement ContractorRFCRoofing Contractor
MCCMarine Construction ContractorSPCSpecialty Contractor
WCCWater / Sewer ContractorISCIncidental Service Contractor
TCCTelecommunications ContractorFPCFire Protection Contractor
BDCBuilding Demolition ContractorLSCLandscape Service Contractor

🧪 Sample Queries & Recipes

Recipe 1 — 1,000+ Active Class A & B Contractors for B2B Outreach

{
"licenseCodes": ["2701", "2705b"],
"statusFilter": "active",
"maxRecords": 1500
}

Recipe 2 — All Active Master & Journeyman Tradesmen (2710)

{
"licenseCodes": ["2710"],
"statusFilter": "active",
"maxRecords": 5000
}

Recipe 3 — Full Unlimited Virginia DPOR Snapshot Across All 10 Categories

{
"licenseCodes": [],
"statusFilter": "all",
"maxRecords": 0,
"requestDelay": 200
}

⚙️ How to Use & API Examples

Python (apify-client)

from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("haketa/virginia-dpor-license-scraper").call(run_input={
"licenseCodes": ["2701", "2705b", "2705c"],
"statusFilter": "active",
"maxRecords": 2000,
})
for record in client.dataset(run["defaultDatasetId"]).iterate_items():
print(record["licenseNumber"], record["name"], record["city"], record["email"])

Node.js (apify-client)

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('haketa/virginia-dpor-license-scraper').call({
licenseCodes: ['2710'],
statusFilter: 'active',
maxRecords: 1000,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Extracted ${items.length} active Virginia tradesman licenses`);

cURL

curl -X POST "https://api.apify.com/v2/acts/haketa~virginia-dpor-license-scraper/runs?token=YOUR_APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"licenseCodes":["2701","2710"],"statusFilter":"active","maxRecords":1000}'

🔌 Integrations & Automation

  • Google Sheets & Excel: Export directly to .xlsx or .csv, or sync nightly into Google Sheets to filter contractors by city, zipCode, classification, or specialties.
  • CRM & Outbound Enrichment (HubSpot, Salesforce, Pipedrive, Apollo): Push contractors with valid email and Active status straight into outbound sequences via Make, Zapier, or n8n.
  • Data Warehouses (Snowflake, BigQuery, Postgres): Schedule weekly full snapshots (maxRecords: 0) and upsert on (licenseNumber, licenseCode) to track new licensees and upcoming expirations.

💡 Tips for Best Results

  • Filter Master vs. Journeyman tradesmen easily: In 2710 (Tradesman Combined), any specialty code starting with M (MELE, MPLB, MHVA, MGFC) is a Master tradesman; J (JELE, JPLB, JHVA, JGFC) is a Journeyman.
  • Target upcoming renewals: Keep statusFilter: "active" and filter expirationDate for the next 60–90 days to reach contractors right before renewal deadlines.
  • Use uppercase when filtering cities downstream: DPOR publishes city names in uppercase (VIRGINIA BEACH, NORFOLK, CHESAPEAKE, RICHMOND, ARLINGTON, FAIRFAX).

❓ FAQ

Do I need proxies or a Virginia DPOR login?

No. DPOR serves the regulant lists publicly over HTTPS, so no login, no API key, and no proxy are needed (useApifyProxy: false by default).

How fast is a 1,000+ record run?

Because the actor downloads the bulk regulant files directly and streams records in 500-item batches, a 1,000-record run typically finishes in 4–10 seconds for fractions of a cent.

Why is businessName null on some records and individualName null on others?

Contractor licenses (2701, 2705b, 2705c) are issued to business entities (businessName is 100% populated), whereas tradesman and inspector licenses (2710, 2709, 2717–2723) are issued to individuals (individualName is 100% populated). The name field automatically merges both and is 100% populated on every record.

Why is email populated on ~60–72% of records?

DPOR includes the registrant's email address whenever one was provided on their application or renewal (~60% on tradesmen, ~72% on Class A contractors).


Need contractor or professional licensing data across other US states and federal registries? Pair this actor with our sibling scrapers:


📋 Changelog

v1.2.0 (2026-11)

  • High-Speed Batched Dataset Streaming (500 records/batch): Replaced single-row dataset writes with 500-record batch pushes, accelerating 1,000+ and 10,000+ record extracts by over 10×.
  • Built-In Deduplication & Multi-Category Overflow Top-Up: Added licenseCode:licenseNumber deduplication (0% duplicates) and an automatic overflow top-up buffer so multi-category runs (licenseCodes: []) with maxRecords: 1000+ always reach the full requested count even when smaller specialty categories have fewer active records.
  • Live Status Messages: Added real-time Actor.setStatusMessage progress updates during downloads and batch writes.
  • Documentation Upgrade: Added ⚡ At a Glance summary table, emoji-grouped field tables with coverage indicators, and this changelog.

v1.1.0 (2026-11)

  • Verified Output Quality: Confirmed 100% coverage on core fields (licenseNumber, name, licenseType, licenseCode, board, occupation, classification, specialties, status, expirationDate), ~99.8% address coverage, and ~60–72% email coverage.
  • ZIP & Address Normalization: Stripped meaningless -0000 ZIP extensions while preserving real ZIP+4 codes.

v1.0.0 (2026-04)

  • Initial release of Virginia DPOR Professional License Scraper covering all 10 bulk regulant categories (2701, 2705b, 2705c, 2710, 2709, 2717, 2718, 2719, 2722, 2723) with Latin-1 safe decoding, specialty array splitting, and expiration-based status derivation.