Primary taxonomy
primary_taxonomy
Optional
Primary NUCC taxonomy description — what this provider actually practises as.
License Verification API — Nurses, MDs & OIG Exclusions
Pricing
from $5.50 / 1,000 results
Primary source verification for US professional licenses. Search 19 state boards by name or license number: status, expiration, disciplinary actions. Cross-checks the NPPES NPI registry and screens the HHS-OIG exclusion list. Bulk roster screening. Newly licensed clinicians feed (roster-delta).
Pricing
from $5.50 / 1,000 results
Rating
0.0
(0)
Developer
Kyle Maloney
Maintained by CommunityActor stats
0
Bookmarked
4
Total users
0
Monthly active users
4 days ago
Last modified
Categories
Share
License number
license_number
Optional
State-issued professional license number.
License type / profession
license_type
Optional
Profession or license category.
Title
title
Optional
Short title/abbreviation for the license (e.g. RN).
Status (raw)
status
Optional
License status exactly as the board publishes it.
First name
first_name
Optional
Licensee first name.
Last name
last_name
Optional
Licensee last name (or the full combined name on boards that publish one field).
Business name
business_name
Optional
Business or DBA name, if applicable.
City
city
Optional
Licensee city.
State
state
Optional
Two-letter state code.
ZIP
zip
Optional
Licensee ZIP code.
County
county
Optional
Licensee county.
Original issue date
original_issue_date
Optional
Date the license was first issued (ISO).
Expiration date
expiration_date
Optional
License expiration date (ISO).
Specialty
specialty
Optional
Specialty or qualifier, if any.
Ever disciplined
ever_disciplined
Optional
True if the board flags a disciplinary history on this licensee.
Discipline reason
discipline_reason
Optional
Reason for disciplinary action, if any.
Discipline action
discipline_action
Optional
Type of disciplinary action taken.
Board state
board_state
Optional
Two-letter state of the board that issued the license.
Source agency
source_agency
Optional
Issuing agency.
Source URL
source_url
Optional
Link to the official primary-source verification page.
Roster: first name searched
roster_first_name
Optional
Batch roster mode — the first name searched for this verdict row.
Roster: last name searched
roster_last_name
Optional
Batch roster mode — the last name searched for this verdict row.
Roster: requested state
roster_state
Optional
Batch roster mode — the state requested, or null if every board was searched.
Match found
match_found
Optional
True if at least one license record was found for this roster entry.
Match count
match_count
Optional
Number of candidate license records found across the searched boards.
Best-match confidence
best_match_confidence
Optional
'exact' (strong, untied identification), 'partial' (weak or tied), or 'none'.
Roster: license number (best match)
license_no
Optional
License number of the best-matching record for this roster entry.
Roster: license status (best match)
license_status
Optional
Raw license status of the best-matching record.
Is active
is_active
Optional
True when the license is in good standing. Derived from the board-specific status vocabulary, not a substring guess. Null when nothing could be verified.
Roster: source agency (best match)
source
Optional
Issuing agency of the best-matching record.
Checked at
checked_at
Optional
ISO timestamp of the verification.
Record type
record_type
Optional
'license' for a single-search license record, 'roster_verdict' for a batch verdict row.
Verdict
verdict
Optional
Credentialing verdict: LICENSED_ACTIVE, LICENSED_NOT_ACTIVE, AMBIGUOUS, NOT_FOUND, or INCONCLUSIVE_SOURCE_ERROR. INCONCLUSIVE_SOURCE_ERROR means a source could not be reached — it is NOT evidence the person is unlicensed.
Match score
match_score
Optional
Identity confidence 0-100: last name exact 30, first name exact 25, middle initial 10, NPI license join 25, profession agreement 10.
Match tier
match_tier
Optional
verified_npi_join | exact_name_single_state | exact_name_multi_state | surname_only | none.
Match reasons
match_reasons
Optional
Comma-separated list of which signals contributed to the score.
Candidates returned
candidates_returned
Optional
How many candidate records were scored for this verdict.
Candidates tied
candidates_tied
Optional
How many candidates tied for the top score. Greater than 1 forces an AMBIGUOUS verdict.
Candidates truncated
candidates_truncated
Optional
True when a board hit the per-board fetch cap, so more candidates may exist than were scored.
Board ID
board_id
Optional
Identifier of the specific board the best-matching record came from.
Board coverage
board_coverage
Optional
Plain-English description of exactly what that board covers.
Status class
status_class
Optional
Normalized status: active | inactive | expired | revoked | deceased | unknown.
Boards searched
boards_searched
Optional
Every board that was queried for this row.
Boards searched (count)
boards_searched_count
Optional
How many boards were queried.
Boards FAILED
boards_failed
Optional
Boards that could not be reached. If this is non-empty, a NOT_FOUND result cannot be trusted — the verdict becomes INCONCLUSIVE_SOURCE_ERROR.
Boards failed (count)
boards_failed_count
Optional
How many boards could not be reached.
Boards failed (detail)
boards_failed_detail
Optional
Per-board failure reason, so a source outage is auditable.
Unsupported filters
unsupported_filters
Optional
Filters you asked for that this board has no column for and therefore could not apply.
Middle name
middle_name
Optional
Licensee middle name, where the board publishes it. Used to break same-name ties.
Nursing school
nursing_school
Optional
Basic nursing education institution (Texas Board of Nursing).
State of original licensure
state_of_original_licensure
Optional
State that first licensed this nurse (Texas Board of Nursing).
Primary practice setting
practice_setting
Optional
Self-reported practice setting (Texas Board of Nursing).
NPI
npi
Optional
National Provider Identifier from the federal NPPES registry.
NPI status
npi_status
Optional
NPPES enumeration status.
NPI credential
npi_credential
Optional
Credential string the provider reported to NPPES (e.g. RN, M.D., LCSW).
Primary taxonomy
primary_taxonomy
Optional
Primary NUCC taxonomy description — what this provider actually practises as.
Taxonomy code
taxonomy_code
Optional
Primary NUCC taxonomy code.
NPI-reported license number
npi_license_number
Optional
The state license number the provider self-reported to NPPES. This is the join key that resolves same-name ambiguity.
NPI-reported license state
npi_license_state
Optional
State of the NPPES-reported license.
Practice city
practice_city
Optional
Primary practice location city from NPPES.
Practice state
practice_state
Optional
Primary practice location state from NPPES.
Practice address
practice_address
Optional
Primary practice street address from NPPES.
OIG excluded
oig_excluded
Optional
TRUE only when matched to the HHS-OIG exclusion list by NPI, or by last+first+state. A surname-only hit never sets this.
Exclusion match basis
exclusion_match_basis
Optional
How the exclusion was matched: 'npi' (authoritative), 'name_state' (probable), or 'surname_only_review' (a namesake exists — review required, NOT an exclusion).
Exclusion type
exclusion_type
Optional
Social Security Act section under which the person was excluded (e.g. 1128b4).
Exclusion date
exclusion_date
Optional
Date the exclusion took effect (ISO).
Reinstatement date
reinstatement_date
Optional
Date the person was reinstated, if applicable (ISO).
Exclusion specialty
exclusion_specialty
Optional
Provider type/specialty recorded on the exclusion record.
Exclusion state
exclusion_state
Optional
State recorded on the exclusion record.
Exclusion review required
exclusion_review_required
Optional
True when someone with the same surname appears on the exclusion list but identity could not be confirmed. Review manually; this is not an exclusion.
Exclusion surname hits
exclusion_surname_hits
Optional
How many exclusion records share this surname. 688 people named SMITH are on the list, which is why surname alone is never sufficient.
Exclusion candidates
exclusion_candidate_count
Optional
How many exclusion records share this exact name and state.
Exclusion candidate name
exclusion_candidate_name
Optional
Full name on the candidate exclusion record, so a reviewer can compare it against the licensee.
Exclusion candidate DOB
exclusion_candidate_dob
Optional
Date of birth on the candidate exclusion record — usually the fastest way to rule a namesake in or out.
Exclusion candidate city
exclusion_candidate_city
Optional
City on the candidate exclusion record.
OIG list as of
leie_as_of
Optional
Publication timestamp of the HHS-OIG exclusion file used for this run.
Board action found
board_action_found
Optional
True if a disciplinary/board action was found. NULL means the disciplinary source could not be checked — it does NOT mean the record is clean.
Board action count
board_action_count
Optional
Number of disciplinary actions found.
Board action type
board_action_type
Optional
Most recent disciplinary action type.
Board action date
board_action_date
Optional
Date of the most recent disciplinary action (ISO).
Board action detail
board_action_detail
Optional
Narrative or profession/board context for the most recent action.
Discipline source
discipline_source
Optional
Which disciplinary dataset the action came from.
Discipline source error
discipline_source_error
Optional
Why a disciplinary lookup failed, when it did.
Mode
mode
Optional
Run mode that produced the row: "roster-delta" for the newly-credentialed feed; null for classic lookup / roster rows.
Feed
feed
Optional
Feed name for roster-delta rows ("roster-delta"); null otherwise.
Event type
event_type
Optional
roster-delta: "inventory" on the seeding run (the whole window), "newly_licensed" on later runs (credential absent from the saved baseline AND issued on/after the previous run minus 7 days).
Event basis
event_basis
Optional
Plain-English reason the row was emitted, naming the issue date, the cutoff and the previous run.
Profession (normalised)
profession
Optional
Credential type with its kind suffix removed ("Registered Nurse License" -> "Registered Nurse"); for TX BON / WA-CPA / NY-NOTARY legs the board's fixed profession. The raw value stays in license_type.
Credential kind
credential_kind
Optional
license | certification | registration | temporary_permit | interim_permit | compact_privilege | probationary | associate | trainee | approval | permit | other — parsed from the credential-type suffix.
Profession filter
profession_filter
Optional
The professions input as applied, pipe-joined; null when no filter was given.
Profession filter matched on
profession_filter_matched_on
Optional
Which professions entry this row satisfied; null when no filter.
Employer
employer
Optional
Texas Board of Nursing place_of_employment when the licensee reported one (RN / LVN); null elsewhere.
Window (days)
since_days
Optional
roster-delta: the sinceDays window applied.
Window since
window_since_date
Optional
roster-delta: first original-issue date in the window (ISO).
Window until
window_until_date
Optional
roster-delta: last original-issue date in the window (ISO, the run date).
Delta scope key
delta_scope_key
Optional
Key of the named KV baseline this run read and wrote (scoped by boards + professions). A different states/professions selection uses a different baseline.
Baseline existed
delta_baseline_seeded
Optional
true when a saved baseline was found and diffed against; false on the seeding run (rows are inventory).
Previous run date
delta_previous_run_at
Optional
Run date of the baseline this run was diffed against; null on the seeding run.
Delta cutoff
delta_cutoff_date
Optional
Earliest issue date a first-seen credential may carry and still be newly_licensed (previous run minus 7 days); null on the seeding run.
Late records suppressed
delta_late_records_suppressed
Optional
Credentials first seen this run but issued BEFORE the cutoff (re-issues, late publication) — added to the baseline, NOT emitted as new.
Already seen
delta_already_seen
Optional
Windowed credentials already present in the baseline this run.
Legs requested
run_legs_requested
Optional
Board ids the run planned to read.
Legs OK
run_legs_ok
Optional
Board ids that passed the drift gate and were read; null if none.
Legs failed
run_legs_failed
Optional
Board ids that failed the gate or the fetch; null if none.
Legs failed reason
run_legs_failed_reason
Optional
Per-board reason for every failed leg (drift vs availability is named).
Legs skipped
run_legs_skipped
Optional
Requested boards that cannot run a delta (no original-issue-date column) or whose fixed profession does not match the filter, with the reason.
Run complete
run_complete
Optional
true when every requested leg answered and no page-loop guard was hit; false means the run is a disclosed partial.
Matched rows total
matched_rows_total
Optional
Events produced by the delta before the maxResults cap.
Results truncated
results_truncated
Optional
true when matched_rows_total exceeded maxResults; the newest credentials are kept.
Rows not emitted (cap)
rows_not_emitted_due_to_cap
Optional
matched_rows_total minus rows emitted.
Max results cap
max_results_cap
Optional
The total row cap applied to this run.
Drift gate status
drift_gate_status
Optional
This row's board: verified | verified_degraded (a corroborating probe could not pass; disclosed) — drifted/unavailable boards emit no rows.
Drift gate note
drift_gate_note
Optional
Every probe outcome with its measurement, e.g. row_count_floor=pass (total 2455566 vs floor 2400000).
Leg server total
leg_server_total
Optional
The source's exact count for this run's window + profession filter (the truncation guard).
Leg rows in window
leg_rows_in_window
Optional
Rows whose issue date parsed and fell inside the window after client-side re-checking.
Leg rows undated
leg_rows_undated
Optional
Fetched rows whose issue date could not be parsed (never guessed, never emitted).
Source data as of
source_data_as_of
Optional
Upstream publication stamp when the source states one; null when it does not.
NPI match confidence
npi_match_confidence
Optional
How the NPI on this row was attributed: license_number_join (NPPES self-reported licence equals this record) | single_candidate | ambiguous (candidates found, none attributable — npi is null) | no_candidate | lookup_failed | not_attempted (npiMaxLookups budget spent) | disabled.