Download or browse the current NUCC Health Care Provider Taxonomy code set from https://www.nucc.org/index.php/code-sets-mainmenu-41/provider-taxonomy-mainmenu-40/code-lookups — the code set is updated twice a year in January and July.
Identify the correct code using the three-level hierarchy: Provider Grouping (e.g., Allopathic & Osteopathic Physicians) > Classification (e.g., Internal Medicine) > Specialization (e.g., Cardiovascular Disease).
Map your taxonomy code to claims: in the X12 837P professional claim, place the taxonomy code in Loop 2000B NPI/taxonomy for billing provider and Loop 2310B for rendering provider using qualifier ZZ in PRV03.
In FHIR resources, represent the taxonomy code in PractitionerRole.specialty using the system http://nucc.org/provider-taxonomy and the 10-character alphanumeric code as the code value.
Validate your selected code against the CMS crosswalk at https://www.cms.gov/medicare/enrollment-renewal/providers-suppliers/health-care-taxonomy to confirm Medicare recognizes the code for enrollment and billing.
When a provider has multiple specialties, select one primary taxonomy for claims; document the primary selection and ensure it matches the primary taxonomy registered in NPPES.
Known gotchas
Taxonomy codes are 10 characters and alphanumeric — do not pad or truncate; a wrong code can cause claim rejections or incorrect payer routing even if the NPI is valid.
The taxonomy code set is released twice yearly; codes can be added, revised, or retired — validate codes at ingestion time and re-validate existing provider records against each new release.
CMS requires taxonomy on Medicare claims but treats it as informational in some contexts; other payers may deny claims outright for missing or incorrect taxonomy — check payer-specific companion guides.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp