Professional License Verification API — Primary Source Verification, NPI Lookup & OIG Exclusion Screening

Nurse license verification, physician license lookup, and provider credentialing automation in one call. Verify US professional licenses against official state board rosters, cross-check the federal NPPES NPI registry, and screen the HHS-OIG LEIE exclusion list — for a single person or a whole roster. Keyless, no captcha, no anti-bot.

Who it's for

• Healthcare credentialing teams doing primary source verification (PSV) before onboarding or during re-credentialing cycles.
• Payer / provider network teams running monthly OIG exclusion monitoring as a condition of billing Medicare and Medicaid.
• Healthcare staffing and travel-nurse agencies doing bulk license verification for a roster of clinicians.
• HR compliance teams running license expiration monitoring across a workforce on a schedule.
• Insurance producer onboarding teams verifying a batch of agents before appointment.
• AI agents needing a "verify a US professional license" tool, single or batch.

What makes this different

Most license lookups return a list of name matches and leave you to guess. This one returns a verdict.

It does this	Why it matters
Names the boards it could not reach	A failed source lookup is reported as INCONCLUSIVE_SOURCE_ERROR, never as "not licensed". You can tell "we checked and found nothing" apart from "we could not check".
Scores identity 0–100	125 Texas RNs are named "Mary Smith". A surname hit is not an identification, and the output says so.
Cross-walks to the NPI registry	The provider's self-reported license number in NPPES pins the exact board record — collapsing those 125 candidates to one.
Screens the federal exclusion list	HHS-OIG LEIE, 83,000+ records. oig_excluded is only ever true on an exact NPI match. A name match is surfaced as a review candidate with its DOB and city attached — because name and state do not identify a person.
Uses each board's real status vocabulary	Texas publishes CURRENT (C), not "Active". A substring guess marks 434,301 active nurses as inactive. This doesn't.

Verdicts

verdict	Meaning
LICENSED_ACTIVE	Confidently identified, license in good standing.
LICENSED_NOT_ACTIVE	Confidently identified; expired, inactive, revoked, surrendered or deceased. See status_class.
AMBIGUOUS	Records found, but identity is not confirmed (weak score or a tie). Supply a first name, middle name, state or license number.
NOT_FOUND	Every board answered, none had a record.
INCONCLUSIVE_SOURCE_ERROR	A source could not be reached. This is not evidence the person is unlicensed. See boards_failed and boards_failed_detail. Emitted in both modes — a single search whose boards all failed returns this one row rather than an empty dataset.

Coverage — what each board actually contains

A bare state code searches every board in that state. "TX" reaches TDLR and all three nursing boards.

Board ID	State	Agency	What it actually covers
IL	Illinois	IDFPR	All professions — medical, nursing, real estate, cosmetology, engineering. Includes disciplinary flag.
CT	Connecticut	CT DCP eLicense	All state credentials — health, trades, professional.
CO	Colorado	CO DORA	All professional and occupational licenses. Disciplinary actions inline (case number, action, date) on 59,319 records.
TX	Texas	TX TDLR	Trades only — contractors, electricians, HVAC, cosmetology. Not healthcare.
TX-BON	Texas	TX Board of Nursing	Registered Nurses (RN) — incl. board-action flag, specialty, nursing school.
TX-LVN	Texas	TX Board of Nursing	Licensed Vocational Nurses (LVN).
TX-APRN	Texas	TX Board of Nursing	APRN / Nurse Practitioners — incl. prescriptive authority status.
WA	Washington	WA DOH	All health professions — nurses, physicians, dentists, therapists, counselors. Real disciplinary flag.
WA-CPA	Washington	WA Board of Accountancy	Certified Public Accountants.
WA-CONTRACTOR	Washington	WA L&I	Registered construction contractors + principal names.
OR	Oregon	OR CCB	Construction contractors (active only).
OR-BCD	Oregon	OR BCD	Electricians, plumbers, boiler, elevator, inspectors.
DE	Delaware	DE DPR	All DPR boards, incl. city/ZIP and issue date. Disciplinary actions joined from the DPR enforcement dataset.
NY	New York	NYS Gaming Commission	Horse-racing occupations only. Not a professional or healthcare credential source.
NY-RE	New York	NY DOS	Real estate salespersons and associate brokers.
NY-COS	New York	NY DOS	Cosmetology, appearance enhancement, barbering.
NY-NOTARY	New York	NY DOS	Commissioned notaries public.
NY-APPRAISER	New York	NY DOS	Certified real estate appraisers.
VT-DFS	Vermont	VT Division of Fire Safety	Electricians, plumbers, gas installers.

Plus, on every run: NPPES NPI Registry (federal, all US providers) and the HHS-OIG LEIE exclusion list (federal, 83,000+ records, refreshed monthly).

What each board does and does not publish

Boards differ in which columns they expose, so some fields are legitimately empty depending on which board answered. board_coverage on every row states what that board covers, and unsupported_filters names any filter it could not apply.

Field	Boards that populate it
city / zip	IL, CO, CT, DE, OR, OR-BCD, NY-RE, NY-APPRAISER, WA-CPA, WA-CONTRACTOR, VT-DFS. Not WA DOH, TX (any), NY, NY-COS, NY-NOTARY.
county	IL, OR, OR-BCD, TX, TX-BON, TX-LVN, TX-APRN, NY-RE, NY-NOTARY, NY-APPRAISER.
specialty	IL, CO, TX-BON, TX-APRN, OR-BCD, WA-CONTRACTOR, VT-DFS, and DE (board category).
ever_disciplined + board_action_found	IL, CO, DE, WA, TX-BON, TX-LVN. null on the rest — meaning not checked, never clear.
discipline_action / discipline_reason / board_action_date	IL (narrative reason), CO (action type, case number, effective date). DE and NY physician actions arrive via the joined enforcement datasets.
nursing_school, state_of_original_licensure, practice_setting	TX-BON and TX-LVN only.
prescriptive_authority_*	TX-APRN only.
npi and the rest of the NPI block	Any board, when the licensee is in NPPES — i.e. healthcare. Empty for trades, notaries and real estate.
title	IL, TX-BON, TX-LVN, TX-APRN, OR, OR-BCD, NY-NOTARY, WA-CPA, WA-CONTRACTOR, VT-DFS.
business_name	IL, CT, CO, TX, NY-RE, NY-APPRAISER, WA-CONTRACTOR.

Verify a Texas RN license

{ "states": ["TX-BON"], "firstName": "Mary", "lastName": "Smith" }

Verify a Washington nurse credential

{ "states": ["WA"], "firstName": "Mary", "lastName": "Galligan", "licenseType": "Registered Nurse" }

Check OIG exclusion status while verifying

Exclusion screening is on by default (screenExclusions) and costs nothing extra per row.

exclusion_match_basis	oig_excluded	Meaning
npi	true	Exact NPI match. Authoritative.
name_state_review	false	Someone with this exact name in this state is excluded. This is not an assertion about your licensee. Compare exclusion_candidate_name, exclusion_candidate_dob and exclusion_candidate_city before acting.
surname_only_review	false	A namesake exists; exclusion_surname_hits says how many. No detail is shown.
null	false	Clean — nothing matched.

This distinction is not pedantry. A live check of "Mary Smith, TX, Registered Nurse" matches LEIE record MARY CLAIRE SMITH (DOB 1951-05-18, Kingsville TX, excluded 1992), while the licensee actually identified is MARY L MURRAY SMITH, license 454090, Travis County, licensed 1980. Same name, same state, same profession, different human being. Only the NPI tells them apart.

Find disciplined licensees

{ "states": ["IL", "WA"], "lastName": "Smith", "onlyDisciplined": true }

Supported on IL, CO, DE, WA and the two Texas nursing boards (RN and LVN). Boards without the column report it in unsupported_filters instead of silently ignoring you.

Bulk license verification for a roster

Verify a whole roster in one run — built for healthcare credentialing, provider network management and HR compliance.

{
  "roster": [
    { "firstName": "Mary", "lastName": "Smith", "state": "TX", "profession": "Registered Nurse" },
    { "firstName": "Jane", "lastName": "Doe", "middleName": "A", "state": "WA" },
    { "firstName": "John", "lastName": "Roe" }
  ]
}

• firstName / lastName — at least one required. Supplying both is the threshold for a confident verdict.
• middleName — optional, breaks same-name ties.
• state — optional. Omit to search every board.
• profession — optional filter, also adds to the match score.

Each entry produces one verdict row, capped at 200 entries per run.

Key output fields

Field	Meaning
verdict	The credentialing decision (table above).
match_score / match_tier	0–100 identity confidence and how it was reached (verified_npi_join is strongest).
candidates_returned / candidates_tied / candidates_truncated	How many people matched, how many tied, and whether the candidate list was capped.
boards_searched / boards_failed / boards_failed_detail	Exactly what was checked and what failed.
license_no, license_status, is_active, status_class, expiration_date	The license itself.
npi, primary_taxonomy, npi_license_number, practice_city, practice_state	NPI cross-walk.
oig_excluded, exclusion_match_basis, exclusion_type, exclusion_date, exclusion_review_required	Federal exclusion screen.
board_action_found, board_action_type, board_action_date	Disciplinary actions. null means could not check, not clean.
checked_at, leie_as_of	Audit trail.

Use as an MCP tool

Available to AI agents via mcp.apify.com as a "verify professional license" and "bulk license verification" tool — pass a name or license number for a single lookup, or a roster array for batch verification.

FAQ

What is primary source verification? Checking a credential directly against the issuing board's own record. Every row carries source_agency and source_url pointing at the official verification page.

Does it include license expiration? Yes — expiration_date on every board that publishes it, normalized to ISO.

Does it include disciplinary and board actions? Yes, where published: IL, CO, DE, WA and the Texas nursing boards carry a flag on the record itself; Colorado adds the case number, action type and effective date inline; Delaware and New York physician actions are also joined from dedicated enforcement datasets. board_action_found is false when the board publishes the column and the licensee is clear, and null when the board publishes no such column at all — so "checked and clear" is never confused with "not checked".

Does it check the OIG exclusion list? Yes — HHS-OIG LEIE, on by default, matched by NPI first. Ideal for monthly exclusion monitoring.

Does it look up NPI numbers? Yes — the NPPES registry, returning NPI, taxonomy and practice address, and using the license number to confirm identity.

Which states? CO, CT, DE, IL, NY, OR, TX, VT, WA across 19 boards, plus two federal sources. See the coverage table.

Any captchas or anti-bot? No. All sources are official open data or public federal APIs.

Source & freshness

State professional-licensing open-data portals (Socrata), the CMS NPPES NPI Registry, and the HHS-OIG LEIE. Official, keyless (optional socrataAppToken raises rate limits). The exclusion list is cached per run and refreshed when OIG publishes a new file — leie_as_of records which edition was used.

Pricing (Pay Per Result)

Billed per row returned.

• A single search that matches nothing returns no rows and costs nothing.
• A roster entry always returns one verdict row and is always billable — including NOT_FOUND and INCONCLUSIVE_SOURCE_ERROR. A verified negative is the deliverable.
• statusOnly returns fewer fields at the same price per row. It is a convenience, not a discount.
• NPI cross-walk, exclusion screening and disciplinary lookups add no per-row cost.