Virginia DPOR Professional License Scraper
Pricing
from $2.50 / 1,000 results
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
Maintained by CommunityActor stats
0
Bookmarked
7
Total users
1
Monthly active users
10 days ago
Last modified
Categories
Features
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.
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
| Feature | Details |
|---|---|
| Data Source | Virginia Department of Professional and Occupational Regulation (DPOR) Regulant Lists |
| License Categories Covered | All 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 Extracted | licenseNumber, name, businessName, individualName, licenseType, licenseCode, classification, specialties[], status, issueDate, expirationDate, address, city, state, zipCode, email |
| Contact Data Included | Direct Registrant Email Address (email, ~60–72% fill) + Full Street & Mailing Address (address, city, state, zipCode) |
| Specialty Code Parsing | Splits multi-code columns into clean arrays (["CBC", "RBC", "H"], ["MELE", "MPLB"]) |
| Status Derivation | Automatically derives Active vs. Expired by comparing expirationDate against run date |
| Scale & Speed | High-speed batched streaming (500 records/batch) — 1,000+ records in < 10 seconds, up to 100,000+ full roster extract (maxRecords: 0) |
| Deduplication | 100% deduplicated within each license code via licenseCode:licenseNumber |
📑 Table of Contents
- Why Scrape Virginia DPOR?
- What This Virginia DPOR Scraper Does
- Use Cases
- Input Configuration
- Output Schema & Field Reference
- Pagination, Batch Streaming & 1,000+ Scale
- License Code & Specialty Reference
- Sample Queries & Recipes
- How to Use & API Examples
- Integrations & Automation
- Tips for Best Results
- FAQ
- Related Scrapers
- Changelog
🔎 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
.txtfiles as UTF-8 corrupts accented characters and company names. - Cryptic uppercase headers: Columns are named
CERTIFICATE #,FIRST LINE ADDRESS,FIVE DIGIT ZIP CODE, andEMAILADDRESS. - 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 compareexpirationDateagainst 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
-0000suffixes 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
licenseCodesempty ([]) to pull a balanced sample across all 10 license types; if smaller specialty categories have fewer records than their share whenmaxRecords: 1000+is requested, the scraper automatically tops up from larger categories so your run always reaches the exactmaxRecordstarget. - ✅ 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
500with built-inlicenseCode:licenseNumberdeduplication, delivering 1,000+ records in under 10 seconds. - ✅ Unified Contractor + Individual Schema — populates
businessNamefor contractor firms,individualNamefor tradesmen, and a mergednamefield on 100% of records so downstream CRM imports never break.
🎯 Use Cases
| Team / Industry | How Teams Use Virginia DPOR License Data |
|---|---|
| Construction Supply, Equipment & SaaS Sales | Build 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-Vetting | Verify subcontractor license numbers, classifications, and expirationDate before bid award or payment release. |
| Skilled-Trades Recruiting & Staffing | Source 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 Bonding | Verify principal licensure at policy bind and renewal; target contractors whose licenses expire within 60–90 days. |
| Home-Services & Property Management | Vet licensed elevator mechanics (2718), fire sprinkler inspectors (2723), backflow prevention workers (2717), and water-well providers (2719). |
| M&A, Legal & Workforce Analytics | Map 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.
| Field | Key | Type | Default | Description |
|---|---|---|---|---|
| License Types | licenseCodes | array<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 Status | statusFilter | string | "all" | "active" keeps only currently valid licenses (expirationDate >= today); "all" returns Active + Expired. |
| Maximum Records | maxRecords | integer | 100 (prefill 100) | Total record cap across all selected categories. Set 0 for unlimited full extract (1,000 to 100,000+ supported). |
| Delay Between Downloads | requestDelay | integer | 200 | Polite pause in milliseconds between downloading each category file (0–10000). |
| Proxy Configuration | proxyConfiguration | object | { "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
| Field | Type | Coverage | Description |
|---|---|---|---|
licenseNumber | string | 🟢 High (100%) | Official DPOR certificate / license number. |
name | string | 🟢 High (100%) | Primary display name (businessName for firms, individualName for individuals). |
businessName | string|null | 🟡 Conditional | Company name — populated 100% on contractor classes (2701, 2705b, 2705c); null on individual tradesmen. |
individualName | string|null | 🟡 Conditional | Person name — populated 100% on individual tradesmen (2710, 2709, 2717–2723); null on contractor firms. |
licenseType | string | 🟢 High (100%) | Human-readable category name (e.g., "Class A Contractor", "Tradesman Combined"). |
licenseCode | string | 🟢 High (100%) | DPOR regulant list code (2701, 2705b, 2705c, 2710, etc.). |
🛠️ Classification, Specialties & Status
| Field | Type | Coverage | Description |
|---|---|---|---|
board / occupation | string | 🟢 High (100%) | DPOR regulatory board (27) and occupation code. |
classification | string|null | 🟢 High (99%+) | License rank (A, B, C for contractors; TRAD for tradesmen). |
specialties | array<string>|null | 🟢 High (98%+) | Parsed array of contractor or trade specialty codes (["CBC", "RBC"], ["MELE", "JPLB"]). |
status | string | 🟢 High (100%) | Derived status: "Active" (expirationDate >= today), "Expired", or "Unknown". |
issueDate | string|null | 🟢 High (99%+) | Original certification date normalized to YYYY-MM-DD. |
expirationDate | string|null | 🟢 High (100%) | License expiration date normalized to YYYY-MM-DD. |
📍 Contact & Location
| Field | Type | Coverage | Description |
|---|---|---|---|
email | string|null | 🟢 High (~60–72%) | Direct registrant email address on file with DPOR. |
address | string|null | 🟢 High (99.8%) | Merged street line 1, street line 2, and PO Box. |
city | string|null | 🟢 High (99.8%) | Registrant city (uppercase, e.g., RICHMOND, VIRGINIA BEACH, ARLINGTON). |
state | string|null | 🟢 High (99.8%) | State abbreviation (predominantly VA, plus out-of-state licensed firms). |
zipCode | string|null | 🟢 High (99.8%) | Cleaned ZIP / ZIP+4 code (meaningless -0000 suffixes stripped). |
country | string|null | 🟡 Conditional | Populated only for international registrants; null for US domestic records. |
scrapedAt | string | 🟢 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, or0(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 (
500rows/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
licenseCodesis left empty ([]) andmaxRecordsis 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
| Code | License Type | Typical Holders | Contract Value / Scope |
|---|---|---|---|
2701 | Class A Contractor | Large construction firms | Unlimited single-contract & annual value ($120K+ single / $750K+ annual) |
2705b | Class B Contractor | Mid-size construction firms | Single contract $10K–$120K; annual $150K–$750K |
2705c | Class C Contractor | Small firms & sole proprietors | Single contract $1K–$10K; annual up to $150K |
2710 | Tradesman Combined | Individual tradespeople | Master & Journeyman Electricians, Plumbers, HVAC, Gas Fitters |
2709 | Residential Tradesman | Individuals | Residential-scoped trade registrations |
2717 | Backflow Prevention Device Worker | Individuals | Certified cross-connection backflow testers |
2718 | Certified Elevator Mechanic | Individuals | Elevator and escalator installation, repair & inspection |
2719 | Certified Water Well Systems Provider | Individuals / firms | Water well drilling and pump installation |
2722 | Residential Building Energy Analyst | Individuals | Residential energy performance auditors & modelers |
2723 | Automatic Fire Sprinkler Inspector | Individuals | Certified fire sprinkler system inspectors |
Tradesman Designation Codes (2710, 2709)
| Master Code | Journeyman Code | Trade Specialty |
|---|---|---|
MELE | JELE | Electrician |
MPLB | JPLB | Plumber |
MHVA | JHVA | HVAC (Heating, Ventilation & Air Conditioning) |
MGFC | JGFC | Gas Fitter — Contractor |
MLPG | JLPG | Liquefied Petroleum Gas Fitter |
MNGF | JNGF | Natural Gas Fitter |
Contractor Specialty Codes (2701, 2705b, 2705c)
| Code | Specialty Description | Code | Specialty Description |
|---|---|---|---|
CBC | Commercial Building Contractor | RBC | Residential Building Contractor |
H | Highway / Heavy Construction | ELE | Electrical Contractor |
PLB | Plumbing Contractor | HVA | HVAC Contractor |
GFC | Gas Fitting Contractor | EMC | Electronic / Mechanical Contractor |
EEC | Elevator / Escalator Contractor | VCC | Vessel Construction Contractor |
CIC | Commercial Improvement Contractor | RFC | Roofing Contractor |
MCC | Marine Construction Contractor | SPC | Specialty Contractor |
WCC | Water / Sewer Contractor | ISC | Incidental Service Contractor |
TCC | Telecommunications Contractor | FPC | Fire Protection Contractor |
BDC | Building Demolition Contractor | LSC | Landscape 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 ApifyClientclient = 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
.xlsxor.csv, or sync nightly into Google Sheets to filter contractors bycity,zipCode,classification, orspecialties. - CRM & Outbound Enrichment (HubSpot, Salesforce, Pipedrive, Apollo): Push contractors with valid
emailandActivestatus 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 withM(MELE,MPLB,MHVA,MGFC) is a Master tradesman;J(JELE,JPLB,JHVA,JGFC) is a Journeyman. - Target upcoming renewals: Keep
statusFilter: "active"and filterexpirationDatefor 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).
🔗 Related Scrapers
Need contractor or professional licensing data across other US states and federal registries? Pair this actor with our sibling scrapers:
- Arizona ROC Contractor License Scraper — Arizona Registrar of Contractors
- California DCA Professional License Scraper — California Department of Consumer Affairs
- Colorado Professional License Scraper — Colorado DORA
- Illinois IDFPR License Scraper — Illinois professional licensing
- Minnesota DLI Professional License Scraper — Minnesota Department of Labor & Industry
- North Carolina Licensing Board for General Contractors Scraper — NCLBGC
- Ohio eLicense Scraper — Ohio multi-board licensing
- Washington L&I Contractor License Scraper — Washington Labor & Industries
- BBB Business Scraper — Better Business Bureau profiles, ratings, and contacts
📋 Changelog
v1.2.0 (2026-11)
- High-Speed Batched Dataset Streaming (
500records/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:licenseNumberdeduplication (0%duplicates) and an automatic overflow top-up buffer so multi-category runs (licenseCodes: []) withmaxRecords: 1000+always reach the full requested count even when smaller specialty categories have fewer active records. - Live Status Messages: Added real-time
Actor.setStatusMessageprogress updates during downloads and batch writes. - Documentation Upgrade: Added
⚡ At a Glancesummary 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
-0000ZIP 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.