Skip to contents

Provider Taxonomies

Source: R/taxonomy.R
taxonomy_codes.Rd

taxonomy_codes() returns a tibble() of the current Health Care Provider Taxonomy code set

Update Frequency: Biannually

Usage

taxonomy_codes(shape = c("wide", "long"))

Source

https://www.nucc.org/index.php/code-sets-mainmenu-41/provider-taxonomy-mainmenu-40/csv-mainmenu-57

Arguments

shape

shape of the data frame returned, 'wide' or 'long'

Value

A tibble with the columns:

Taxonomy Codes

The Health Care Provider Taxonomy code set is a collection of unique alphanumeric codes, ten characters in length. They contain no embedded logic.

The code set Levels are organized to allow for drilling down to the provider's most specific level of specialization, with three distinct "Levels":

Level I Provider Grouping

A major grouping of service(s) or occupation(s) of health care providers.

Examples: Allopathic & Osteopathic Physicians, Dental Providers, Hospitals

Level II Classification

A more specific service or occupation related to the Provider Grouping.

For example, the classification for Allopathic & Osteopathic Physicians is based upon the General Specialty Certificates as issued by the appropriate national boards.

The following boards will, however, have their general certificates appear as Level III Areas of specialization strictly due to display limitations of the code set for Boards that have multiple general certificates:

Medical Genetics, Preventive Medicine, Psychiatry & Neurology, Radiology, Surgery, Otolaryngology, Pathology

Level III Area of Specialization

A more specialized area of the Classification in which a provider chooses to practice or make services available.

For example, the area of specialization for Allopathic & Osteopathic Physicians is based upon the Subspecialty Certificates as issued by the appropriate national boards.

Categories (Level 0)

The code set includes three specialty categories:

Group (of Individuals):

  1. Multi-Specialty

  2. Single Specialty

Individuals:

  1. Allopathic & Osteopathic Physicians

  2. Behavioral Health and Social Service Providers

  3. Chiropractic Providers

  4. Dental Providers

  5. Dietary and Nutritional Service Providers

  6. Emergency Medical Service Providers

  7. Eye and Vision Service Providers

  8. Nursing Service Providers

  9. Nursing Service Related Providers

  10. Other Service Providers

  11. Pharmacy Service Providers

  12. Physician Assistants and Advanced Practice Nursing Providers

  13. Podiatric Medicine and Surgery Service Providers

  14. Respiratory, Developmental, Rehabilitative and Restorative Service Providers

  15. Speech, Language and Hearing Service Providers

  16. Student, Health Care

  17. Technologists, Technicians, and Other Technical Service Providers

Non-Individuals:

  1. Agencies

  2. Ambulatory Health Care Facilities

  3. Hospital Units

  4. Hospitals

  5. Laboratories

  6. Managed Care Organizations

  7. Nursing and Custodial Care Facilities

  8. Other Service Providers

  9. Residential Treatment Facilities

  10. Respite Care Facilities

  11. Suppliers

  12. Transportation Services

Display Name

The display name is a combination of the code name and the Level in which the code is nested, which more precisely identifies the code.

For example, Addiction Medicine is a physician subspecialty in Anesthesiology, Family Medicine, Internal Medicine, Preventive Medicine, and Psychiatry & Neurology.

"Addiction Medicine" does not identify the specialty of the physician, but the display name of "Addiction Medicine (Internal Medicine) Physician" clearly does.

In another example, "Radiology" could be confused with several taxonomies, but "Radiology Chiropractor" more accurately specifies the provider.

Description

  • taxonomy_code: Provider Taxonomy Code

  • taxonomy_category: Indicates whether Taxonomy is Individual or Non-Individual, i.e., a group taxonomy

  • taxonomy_grouping: Level I, Provider Grouping

  • taxonomy_classification: Level II, Classification

  • taxonomy_specialization: Level III, Area of Specialization

  • taxonomy_display_name: Consumer-friendly taxonomy name, made of the code name and the Level in which the code is nested.

  • taxonomy_definition: Definition of Taxonomy

  • version: Three digit version of the code set. The first two digits indicate the year and the third digit indicates either the first release of the year ("0") or the second release of the year ("1").

  • release_date: Date the version of the code set was released

Examples

if (FALSE) { # interactive()
taxonomy_codes()
}