Virginia Contractor License Lookup (DPOR Bulk) avatar

Virginia Contractor License Lookup (DPOR Bulk)

Pricing

$0.004 / license records

Go to Apify Store
Virginia Contractor License Lookup (DPOR Bulk)

Virginia Contractor License Lookup (DPOR Bulk)

Download and filter 50,000+ Virginia DPOR contractor licenses — Class A, B & C plus tradespeople — by name, or by county, city, ZIP and trade, direct from the official regulant lists. No CAPTCHA, no auth.

Pricing

$0.004 / license records

Rating

0.0

(0)

Developer

ScrapeBench

ScrapeBench

Maintained by Community

Actor stats

0

Bookmarked

65

Total users

6

Monthly active users

2 days ago

Last modified

Categories

Features

Limited permissions

Share

Pain points

  • Verifying or sourcing Virginia contractors one at a time through the DPOR search portal is slow, and the portal offers no bulk view of the roster.
  • No easy way to pull the full Class A/B/C contractor roster for lead-gen, compliance, or enrichment workflows.
  • The raw DPOR regulant-list files are tab-delimited and hard to work with without a parser.

What we solve

  • Download the full Virginia DPOR contractor roster — 50,000+ records across Class A, B, and C — in one run.
  • Filter by name, city, or license type without running a single portal search.
  • Returns structured records: license number, rank, specialties, address, expiration date, and email.

Summary

Pull the full Virginia DPOR contractor and tradesperson roster without touching the search portal at all. DPOR publishes free public regulant lists as tab-delimited files refreshed every ~5 business days - this actor downloads them, parses them, and returns structured records for Class A, Class B, Class C contractors, residential tradespeople, and specialty trades. Filter by name, city, or license type, or pick a county or independent city, mailing city or ZIP and a trade (Roofing, Electrical, HVAC, Home Improvement...) for every matching contractor with the county derived from the ZIP; pay per match. Built for lead-gen, compliance workflows, and multi-state contractor data pipelines.

Who it's for

  • Sales and BD teams building lead lists of Virginia contractors by specialty or location
  • Compliance teams verifying DPOR licensure status for vetting or KYC workflows
  • Insurance underwriters running portfolio checks on contractor clients
  • Data platforms normalizing multi-state contractor license data

Virginia contractor license lookup: example input

This actor does two jobs. Run it, then collect results from the run's dataset (export to JSON/CSV/Excel, or pull via the Apify API).

Get a list (export): no names, just filters; returns the whole matching list.

{
"counties": [
"Fairfax County"
],
"trades": [
"Roofing"
],
"maxResults": 500
}

Check specific firms (lookup): put company names or licence numbers in nameFilters; Inputs below says how each is matched.

{
"nameFilters": [
"SUMPTER LLC"
],
"maxResults": 5
}

See Inputs below for every available field.

Virginia contractor license lookup: output data

One row per record:

FieldDescription
license_numberDPOR certificate number (e.g. 082040)
license_typeLicense category (Class A Contractor, Class B Contractor, etc.)
license_rankDPOR rank code (A, B, C, RETR, BPDW, CEM, etc.)
business_nameLicensed business name (for firm licenses)
individual_nameLicensee personal name (for individual licenses)
addressStreet address
cityCity
stateState code
zip_codeZIP code
countryCountry (blank for domestic)
expiration_dateLicense expiration date (MM/DD/YYYY)
certification_dateOriginal certification date (MM/DD/YYYY)
specialtiesList of DPOR specialty codes (e.g. CBC, ELE, H/H, EMW)
emailContact email address
source_urlDPOR regulant lists page
countyCounty / city searches: county derived from the mailing ZIP (approximate)
county_methodHow the county was derived: zip_single, zip_majority, unmapped, out_of_state
specialty_labelsCounty / city searches: each DPOR specialty code spelled out

Sample:

{
"license_number": "082040",
"license_type": "Class A Contractor",
"license_rank": "A",
"business_name": "CORNERSTONE ENGINEERING AND CONSULTING SERVICES PLLC",
"individual_name": null,
"address": "1272 NELLIE JONES RD",
"city": "LA CROSSE",
"state": "VA",
"zip_code": "23950",
"country": null,
"expiration_date": "02/29/2028",
"certification_date": "02/03/2004",
"specialties": [
"EMW",
"ENV"
],
"email": "bdougherty@cornerstoneusa.net",
"source_url": "https://www.dpor.virginia.gov/RegulantLists"
}

Virginia contractor license lookup: input fields

FieldRequiredTypeDefaultDescription
modenostring"auto"auto (default): names below run a name search, a county / city / ZIP / trade runs the directory export, nothing exports the licence types picked. lookup: name search only. export: names ignored.
queriesnoarray[]Same as 'Name filters': business or individual names, each matched as a case-insensitive substring. DPOR publishes no licence-number search.
querynostring—One name; same as 'Name filter'.
licenseTypesnoarray["class_a", "class_b", "class_c"]Which DPOR license categories to include. Leave empty for Class A, B, and C contractors. Valid values: class_a, class_a_legacy, class_b, class_c, temporary, residential_tradesman, backflow_prevention, elevator_mechanic, water_well_provider, accessibility_mechanic, energy_analyst, energy_analyst_firm, sprinkler_inspector.
nameFilternostring—Only return records where the individual or business name contains this text (case-insensitive). Leave blank for all.
nameFiltersnoarray[]Look up many in ONE run instead of starting a run per lookup. Takes the same values as 'Name filter'. Combined with 'Name filter' if you fill both, and duplicates are removed. Billing is unchanged: you are charged per record returned, not per entry submitted.
cityFilternostring—Only return records where the city contains this text (case-insensitive). Leave blank for all.
maxResultsnointeger500Cap on the number of records returned PER ENTRY, not per run — so a batch cannot silently return only the first 500 rows overall and read as 'the rest don't exist'.
countynostring—Directory export (by place and trade, with county derived from the ZIP): A Virginia county or independent city, e.g. 'Fairfax County', 'Richmond city', 'City of Fairfax', 'Loudoun'. Fairfax, Franklin, Richmond and Roanoke are each both a county and a city, so say which. APPROXIMATE: DPOR records no county, so it is derived from the mailing ZIP (each row's county_method says how). For an exact match use City or ZIP. An unrecognised name returns the free county and trade lists instead of failing.
countiesnoarray[]Directory export (by place and trade, with county derived from the ZIP): Several counties or independent cities in ONE run. Combined with 'County' if you fill both.
citynostring—Directory export (by place and trade, with county derived from the ZIP): The city on the licence's mailing address, e.g. 'Vienna', 'Virginia Beach'. Exact match, case-insensitive.
citiesnoarray[]Directory export (by place and trade, with county derived from the ZIP): Several mailing cities in ONE run, each searched separately.
zipnostring—Directory export (by place and trade, with county derived from the ZIP): A 5-digit ZIP code, matched exactly against the licence's mailing ZIP, e.g. '22182'.
zipsnoarray[]Directory export (by place and trade, with county derived from the ZIP): Several ZIP codes in ONE run, each searched separately.
tradenostring—Directory export (by place and trade, with county derived from the ZIP): A DPOR trade, by name or code, e.g. 'Roofing', 'Electrical', 'HVAC', 'Home Improvement', 'ROC'. A word from the name works too: 'roof' finds Roofing. Leave it empty to get every trade in the place.
tradesnoarray[]Directory export (by place and trade, with county derived from the ZIP): Several trades in ONE run, e.g. Roofing and Electrical. Combined with 'Trade' if you fill both. A contractor holding two of them is returned (and billed) once.
licenseClassesnoarray—Directory export (by place and trade, with county derived from the ZIP): Which DPOR licence classes to include: A, B, C, and RETR (residential tradesman). Only those files are downloaded. Empty = A, B and C; when empty, the License types above pick the classes.
inVirginiaOnlynoboolean—Directory export (by place and trade, with county derived from the ZIP): Keep only licences with a Virginia mailing address. About 20% of DPOR's licences have an out-of-state address; turn this off to include them on a statewide trade search. Unset = on.
listOptionsOnlynobooleanfalseDirectory export (by place and trade, with county derived from the ZIP): If true, skip the download and return Virginia's 95 counties and 35+ independent cities plus every trade DPOR's Board for Contractors licenses, with its code. Free, not charged.
expiresAfternostring—Only licences expiring on or after this date (YYYY-MM-DD). With 'Expires on or before' it lists licences due for renewal in a window. Works on exports and name searches.
expiresBeforenostring—Only licences expiring on or before this date (YYYY-MM-DD).
proxyConfigurationnoobject{"useApifyProxy": false}Optional. DPOR's files are reachable directly; a proxy is not needed.

Pricing (Pay Per Event)

You pay per result (dataset-item) — no charge for empty runs. Example: 1000 license records at $0.004/result ≈ $4.00.

Illustrative — the final per-result price is set at publish time.

Virginia contractor license lookup use cases

  • Lead generation — pull all Class A contractors in a Virginia city as a prospect list for subcontracting or supply-chain outreach.
  • Compliance verification — download the full Class B/C roster and cross-check your vendor list against current DPOR records.
  • Multi-state enrichment — join Virginia DPOR records with other state rosters for a national contractor data pipeline.
  • Specialty targeting — filter by license type (e.g. elevator mechanics, backflow prevention workers) for niche trade outreach.

Why this actor

  • Straight from the official DPOR regulant lists — same data the state publishes, structured and queryable.
  • Uses DPOR's own free bulk regulant-list files - no search portal, no per-record lookups.
  • Covers all contractor classes (A, B, C) plus 10+ specialty trade categories in one actor.
  • Pay per match; no charge for runs that return no results.

Limitations & updates

Data is refreshed by DPOR every ~5 business days; records may lag real-time changes by up to one week. The DPOR files do not include phone numbers (DPOR explicitly excludes them). No status field is present in the source data — expiration date is the best proxy for active vs. expired licenses. Specialty codes (CBC, ELE, H/H, etc.) are DPOR internal abbreviations; a code legend is available on the DPOR website. The actor covers DPOR-licensed categories only — some Virginia trades are licensed at the local level and are not in these files. A county / city / ZIP / trade search returns its own row shape (county, county_method, license_class, specialty_labels, requested_*): DPOR publishes no county, so it is derived from the mailing ZIP and is approximate (a ZIP crossing a county line goes to the county holding most of its land; PO-box ZIPs have none; a few small independent cities cannot be reached by county, and the run says which ZIPs to use). Out-of-state addresses are left out of those searches unless 'Virginia addresses only' is turned off.

Virginia contractor license lookup FAQ

Where does the data come from?

Virginia DPOR publishes free public 'Regulant Lists' as tab-delimited files updated every ~5 business days. This actor downloads and parses those official files directly.

What license types are covered?

Class A, B, and C contractors (the main categories); plus residential tradespeople, backflow prevention workers, elevator mechanics, water well providers, accessibility mechanics, residential energy analysts, and sprinkler inspectors. See licenseTypes input for the full list.

How current is the data?

DPOR refreshes the regulant-list files every ~5 business days (usually Mondays). Each run fetches the current file at that moment.

Can I filter by specialty?

Each record includes a specialties field (e.g. CBC = Commercial Building Construction, ELE = Electrical, H/H = Heating & Air Conditioning). You can filter post-run on this field; the actor's nameFilter and cityFilter cover the most common pre-run narrowing needs.

Can I get every contractor in a county, by trade?

Yes. Give a county or independent city (Fairfax County, Richmond city), a mailing city or a ZIP, and a trade by name or DPOR code (Roofing, Electrical, HVA). Each search returns every matching licence once, with the county derived from the mailing ZIP. Set 'Discovery Mode' to list the accepted counties and trades for free.

How am I charged?

Pay per license record returned. Runs that return no matching records are not charged.

Does this need any account or API key?

No — the DPOR regulant lists are free public files, no auth required.

Is there an official API for Virginia contractor license data, and why use this instead?

The Virginia Department of Professional and Occupational Regulation (DPOR) publishes free public regulant lists and a search portal, not a keyed API that we know of. This actor reads those public lists and returns structured rows for 50,000+ licences, filterable by name, county, city, ZIP and trade. DPOR does not publish phone numbers.

What are the alternatives to this Virginia contractor license lookup?

Alternatives are DPOR's own search portal (official, one licence at a time) or buying a contractor list. This actor is pay per match with no subscription; confirm anything consequential on the DPOR site.

How do I get a list of Virginia contractors by county and trade?

Set a county or independent city and a trade, as in the example input (Fairfax County, Roofing), and export the result as CSV, Excel or JSON. County is derived from the mailing ZIP, so it is approximate.

Virginia contractor license lookup: run it on a schedule

Open Schedules in Apify Console, add this actor with your input and a cron time, for example: monthly (0 6 1 * *) to re-verify a vendor list, or weekly (0 6 * * 1) for a roster you watch closely. Then send each run's results to Google Sheets, Zapier, Make or n8n from the Integrations tab, or pull the dataset through the Apify API.

Watch: schedule and connect this Actor

Apify's own walkthroughs:

Schedule your Actor (Apify, Getting Started 3/4)

Zapier triggers and actions for Apify Actors

Part of the contractor-license verification suite — pick the one that fits your goal:

  • California Contractor License Lookup & Verify (CSLB) — You need a California contractor verified — by license number, business, or owner/personnel name (CSLB).
  • Louisiana Contractor License Lookup & Leads Scraper (LSLBC) — You want the full Louisiana roster — 50,000+ commercial, residential & specialty licenses as data (LSLBC).
  • North Carolina Contractor License Lookup & Verify (NCLBGC) — You're verifying a North Carolina general contractor — classification, status, expiration (NCLBGC).
  • Nevada Contractor License Lookup & Verify (NSCB) — You need a Nevada contractor's status, trade classifications, bond & principals (NSCB).
  • US Contractor License Lookup & List Scraper (State Boards) — You don't know the state, or want the same contractor checked across many states in one run.

Guides & use cases

Written up on scrapebench.dev — the bench that runs and verifies this actor against the live source every night:

More actors, coverage and nightly verification results: scrapebench.dev

Works with n8n

Ready-made n8n templates that call this actor:

Works with AI assistants (MCP)

Callable as an MCP tool, so Claude, Cursor, VS Code Copilot and other MCP clients can run it directly. Grab the config from the MCP tab on this page — Apify hosts the server and keeps that snippet current, and OAuth signs you in on first connect, so no API token goes in your config file.

Then just ask:

"List Virginia Class A, B and C contractor licences."

It filters the official DPOR regulant lists, so a class filter on its own returns thousands of rows — add a city or name filter to narrow it before you run it from an agent. Runs started this way bill exactly like any other run.

Use it from an AI agent (Agent Skill)

The free scrapebench-contractor-vetting skill teaches Claude Code and other agents to find the right scrapebench Actor for the task and run it. Copy the folder into ~/.claude/skills/, set APIFY_TOKEN, and ask in plain words.

Data & lawful use

This actor collects publicly available information that the Virginia Department of Professional and Occupational Regulation publishes for public lookup — licence records, business listings and the contact details professionals list there. Some of it identifies individuals (sole proprietors, licence holders, agents), so treat any names, phone numbers and emails in your results as personal data.

When you run this actor, you decide what is collected and what it is used for, so you are the controller of that data and we act only as your processor (Apify Standard Actor Contract). You need a lawful basis for your use, must honour opt-out and deletion requests, and must follow the marketing rules that apply to you (CAN-SPAM, TCPA, GDPR, CCPA and similar). Don't use the output for unsolicited bulk messaging, for screening covered by the FCRA, or for anything the source's own terms forbid.

Your results are stored in your own Apify account. We don't keep a copy of your results and don't sell or share them.

Disclaimer

This is an independent tool. It is not affiliated with, endorsed by or sponsored by the Virginia Department of Professional and Occupational Regulation. Names and marks are used only to describe the data source. Records are provided as published by the source and may be out of date or incomplete. For anything consequential (hiring, a permit, a legal decision), confirm the record with the issuing agency. You are responsible for making sure your use complies with applicable law and the source's terms.

Need help?

Open an issue on this actor's Issues tab and we'll respond there. Bug reports, missing fields and feature requests are all welcome. Guides and examples: scrapebench.dev.

If you are a person named in this data and want your record removed from our copy, email apify-help@scrapebench.dev; the source agency remains the official record.

Your run may be used to improve our services. If something looks off, or you want this actor to fit your use better, please share your run data with us: Apify Console → Settings → Security → Share run data with developers. It lets us see exactly what went wrong and keep improving the actor.

If this actor saved you time, a short review on its Store page helps other buyers find it.