West Virginia Physician License Roster Scraper

Download the official West Virginia physician license roster and turn its monthly spreadsheets into clean JSON records.

The Actor reads the West Virginia Board of Medicine's current active-status rosters for:

• medical doctors (MDs),
• physician assistants (PAs), and
• podiatric physicians (DPMs).

Each result includes practitioner identity, profession, credential number, expiration date, active-roster context, official source URL, roster publication date, and retrieval timestamp.

What does this Actor do?

The Board publishes separate Excel workbooks and multiple credential worksheets. This Actor discovers the current official download links, downloads the selected workbooks, and normalizes the rows into one consistent dataset.

You can:

• export a complete profession roster;
• find a practitioner by name;
• look up a credential number;
• select standard or nonstandard credentials;
• limit the dataset for quick checks;
• schedule recurring Apify runs for monthly compliance refreshes;
• send results to spreadsheets, databases, webhooks, or data pipelines.

The Actor does not scrape third-party directories. Every record links back to the official Board roster.

Who is it for?

Healthcare credentialing teams

Refresh active-status source data before onboarding or periodic re-verification.

Compliance teams

Build repeatable snapshots with publication and retrieval dates for audit trails.

Hospitals and staffing companies

Filter official rosters by profession and compare exported datasets between runs.

Researchers and analysts

Convert state-published XLSX files into API-friendly JSON, CSV, or Excel exports.

Developers

Use a stable normalized schema instead of maintaining workbook and worksheet parsing code.

Why use this West Virginia physician license roster scraper?

• Official source — data comes from wvbom.wv.gov.
• Three professions — MD, PA, and DPM rosters use the same output shape.
• Multiple credential types — standard licenses, special licenses, permits, and telehealth registrations are supported when published.
• Current links — workbook URLs are discovered from the roster page on each run.
• Normalized dates — expiration and roster dates use YYYY-MM-DD.
• Provenance included — source URLs, worksheet context, and retrieval time remain attached to every record.
• No browser required — the Actor uses the Board's public roster downloads directly.

What data can I extract?

Field	Meaning
fullName	Combined practitioner name
firstName	First name from the Board workbook
middleName	Middle name or initial, when present
lastName	Last name from the Board workbook
suffix	Name suffix, when present
profession	Normalized profession name
professionCode	MD, PA, or DPM
credentialType	Normalized license, permit, or registration type
licenseNumber	Published credential number
expirationDate	Credential expiration date in YYYY-MM-DD
rosterStatus	Active, reflecting the source roster scope
rosterPublishedDate	Date shown on the Board roster page
rosterContext	Original worksheet status heading
worksheet	Original workbook worksheet name
notes	Board-published notes, when available
sourceUrl	Official workbook download URL
rosterPageUrl	Official roster landing page
retrievedAt	UTC retrieval timestamp

Supported credential types

The credentialTypes input accepts:

Value	Source worksheet scope
license	Standard active licenses
special-license	Special active licenses
temporary-license	Temporary active licenses
educational-permit	Educational permits
reciprocal-educational-permit	Reciprocal educational permits
interstate-telehealth-registration	Interstate telehealth registrations

Not every profession has every worksheet. Selecting an unavailable combination simply yields no rows from that combination.

How to run the Actor

1. Open the Actor in Apify Console.
2. Choose one or more professions.
3. Choose one or more credential types.
4. Optionally enter a practitioner name or credential number.
5. Set the maximum number of records.
6. Click Start.
7. Open the Dataset tab to inspect or export results.

For a complete standard-license refresh, leave all three professions selected, choose license, and raise maxItems to the required volume.

Input parameters

Parameter	Type	Default	Description
professions	string array	MD, PA, DPM	Profession workbooks to download
credentialTypes	string array	license	Worksheet types to include
searchTerm	string	empty	Case-insensitive name or credential-number filter
maxItems	integer	1,000	Maximum records saved, from 1 to 20,000

An empty searchTerm includes all matching roster rows. The search filter is applied after downloading the selected official workbooks.

Input examples

Find a doctor by surname

{
  "professions": ["MD"],
  "credentialTypes": ["license"],
  "searchTerm": "Abadir",
  "maxItems": 10
}

Export active podiatric physicians

{
  "professions": ["DPM"],
  "credentialTypes": ["license"],
  "maxItems": 500
}

Refresh nonstandard physician credentials

{
  "professions": ["MD", "PA"],
  "credentialTypes": [
    "special-license",
    "educational-permit",
    "interstate-telehealth-registration"
  ],
  "maxItems": 2000
}

Output example

A current standard-license record has this shape:

{
  "fullName": "Sample A Physician",
  "firstName": "Sample",
  "middleName": "A",
  "lastName": "Physician",
  "suffix": null,
  "profession": "Medical Doctor",
  "professionCode": "MD",
  "credentialType": "license",
  "licenseNumber": "12345",
  "expirationDate": "2028-06-30",
  "rosterStatus": "Active",
  "rosterPublishedDate": "2026-08-14",
  "rosterContext": "MEDICAL DOCTORS (MDs) WHO HOLD AN ACTIVE STATUS LICENSE",
  "worksheet": "Licenses",
  "notes": null,
  "sourceUrl": "https://wvbom.wv.gov/download_resource.asp?id=000",
  "rosterPageUrl": "https://wvbom.wv.gov/Rosters.asp",
  "retrievedAt": "2026-08-15T12:00:00.000Z"
}

Names and credential numbers in this documentation example are illustrative. Actual datasets contain the public values in the current Board roster.

How much does it cost to download West Virginia physician licenses?

Pricing uses one small run-start charge plus a per-record charge. The exact amount is shown in Apify Console before you start the Actor and varies by your Apify pricing tier.

At the current Bronze tier:

• the run-start charge is $0.00005;
• each saved record is $0.0024;
• 25 records cost about $0.06005;
• 100 records cost about $0.24005;
• 1,000 records cost about $2.40005.

Only records written to the dataset are charged as items. Empty workbook rows, filtered-out rows, and failed downloads are not item charges. Platform compute may be billed separately according to your Apify plan.

Export and integration options

From the default dataset, export results as:

• JSON,
• JSON Lines,
• CSV,
• Excel,
• XML, or
• RSS.

Common workflows include:

1. schedule a run after the Board's monthly roster update;
2. export the dataset to cloud storage;
3. compare professionCode + credentialType + licenseNumber with the prior snapshot;
4. review additions, removals, or changed expiration dates;
5. preserve rosterPublishedDate and retrievedAt in the audit record.

The Actor reports the source's current active-roster context. It does not itself send change alerts or retain historical comparisons. Use Apify schedules, webhooks, integrations, or your own database for those steps.

Run through the Apify API

Replace <APIFY_TOKEN> with your token.

cURL

curl -X POST \
  "https://api.apify.com/v2/acts/automation-lab~west-virginia-physician-license-roster/runs?token=<APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"professions":["DPM"],"credentialTypes":["license"],"maxItems":25}'

To wait for the run and return dataset items:

curl -X POST \
  "https://api.apify.com/v2/acts/automation-lab~west-virginia-physician-license-roster/run-sync-get-dataset-items?token=<APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"professions":["MD"],"credentialTypes":["license"],"searchTerm":"Abadir","maxItems":10}'

JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('automation-lab/west-virginia-physician-license-roster').call({
  professions: ['MD', 'PA', 'DPM'],
  credentialTypes: ['license'],
  maxItems: 1000,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python

from apify_client import ApifyClient

client = ApifyClient("<APIFY_TOKEN>")
run = client.actor("automation-lab/west-virginia-physician-license-roster").call(
    run_input={
        "professions": ["PA"],
        "credentialTypes": ["license"],
        "maxItems": 100,
    }
)
items = client.dataset(run["defaultDatasetId"]).list_items().items
print(items)

Use with MCP and AI agents

Add Apify MCP to Claude Code:

claude mcp add --transport http apify \
  "https://mcp.apify.com?tools=automation-lab/west-virginia-physician-license-roster"

Use this same JSON configuration in Claude Desktop, Cursor, or VS Code:

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=automation-lab/west-virginia-physician-license-roster"
    }
  }
}

• Claude Desktop: add the mcpServers block to the Claude Desktop configuration file.
• Cursor: open MCP settings and add the apify server with the URL shown above.
• VS Code: add the same server definition through your MCP-compatible extension or workspace MCP configuration.

Example prompts:

• “Download the first 100 active West Virginia PA licenses.”
• “Find the active MD roster entry whose name contains Abadir.”
• “Export current DPM license numbers and expiration dates.”
• “Retrieve active interstate telehealth registrations for monthly comparison.”

Reliability and source behavior

The Actor performs up to three bounded attempts for a failed roster page or workbook download. It validates that workbook responses are XLSX files before parsing them. Unrecognized worksheet layouts are skipped with a warning rather than emitted incorrectly.

The source is an official state website and can change without notice. A run fails when the roster page or a selected profession workbook cannot be downloaded after retries. This makes missing refreshes visible instead of silently returning misleading data.

Limits and interpretation

• The source says its roster files are updated monthly, not in real time.
• Active describes inclusion in the Board's active-status roster at publication time.
• For physician assistants, the Board notes that an active credential and an activated practice notification may both be required to practice.
• The Actor does not represent a legal certification of current eligibility to practice.
• The Actor does not provide disciplinary history, private contact details, specialty, or practice-location enrichment.
• Empty source workbook rows are ignored.
• Results follow the Board's spelling and name components.

For an individual decision, review the linked official source and applicable Board guidance.

Troubleshooting

Why did I receive fewer records than maxItems?

maxItems is a ceiling, not a target. Your profession, credential-type, and search filters may match fewer current rows. Some selected profession and credential-type combinations do not exist in the published workbooks.

Why did a name search return no results?

The search is a literal, case-insensitive substring match against the published full name and credential number. Try a last name, a shorter spelling, or the credential number without punctuation.

Why did the run fail during download?

The official Board website may be temporarily unavailable or may have changed its file links. Retry later after checking the official roster page. Persistent failures should be reported with the run ID and input.

Can I download every standard license?

Yes. Select all professions, select license, leave searchTerm empty, and set maxItems high enough for the current roster volume. The input supports up to 20,000 records.

Responsible use and legality

The Actor processes public professional-license roster information published by the West Virginia Board of Medicine. Use it for lawful verification, compliance, research, and data-management purposes.

You are responsible for:

• following applicable laws and contractual obligations;
• avoiding harassment, discrimination, or harmful profiling;
• applying appropriate access controls to exported datasets;
• checking the official source before high-impact decisions;
• respecting corrections and updates published by the regulator.

Public availability does not remove your responsibility to use personal information fairly and securely.

Related Actors

For federal provider identity and taxonomy enrichment, use NPPES NPI Registry Provider Search. It is a separate federal registry and should not be treated as a substitute for West Virginia licensure status.

FAQ

Does this Actor search the Board's individual verification portal?

No. It normalizes the official bulk active-status roster files linked from the Board's roster page.

Are inactive licenses included?

No. The source files are explicitly published as active-status rosters.

Are MD, PA, and DPM values mixed together?

They share one dataset, but profession and professionCode identify every row.

Can I identify changes between months?

Yes, by scheduling runs and comparing datasets externally. Use the profession, credential type, and credential number as a practical composite key.

Is a no-result search charged per item?

No item charge is generated when no record is saved. The one-time run-start charge still applies.

Does the Actor use a proxy?

No. The current official roster and XLSX downloads are accessible through direct HTTP requests.

Is the data real time?

No. The Board's roster page states the publication date and says rosters are updated monthly. Each result preserves that publication date so users can judge freshness.