Data APICode References
NUCC Taxonomy Code Reference
Understanding healthcare provider taxonomy codes and how to query them in the NPI Providers dataset.
NUCC (National Uniform Claim Committee) taxonomy codes are 10-character alphanumeric codes used to classify healthcare providers by specialty. Every NPI provider record includes at least one taxonomy code as their primary specialty, making it the most useful filter for specialty-level analysis.
How Taxonomy Codes Work
Taxonomy codes follow a hierarchical classification with three levels:
| Level | Description | Example |
|---|---|---|
| Provider Type | Top-level grouping | Allopathic & Osteopathic Physicians |
| Classification | Specialty area | Internal Medicine |
| Specialization | Sub-specialty (optional) | Cardiovascular Disease |
The code format is XXXXXXXXXX (10 characters, e.g., 207RC0000X). The prefix identifies the provider type and specialty. There are 873 distinct taxonomy codes in the dataset.
Display Name
Each taxonomy code has a human-readable display_name derived from:
- Classification only (when no specialization):
"Internal Medicine" - Classification + specialization:
"Internal Medicine - Cardiovascular Disease"
URL Slug
Each code also has a URL-safe slug (e.g., internal-medicine, cardiovascular-disease) used in the NPI directory pages at /npi/specialty/{slug}.
Querying Taxonomy Codes
Use the primary_taxonomy_code column on the npi_providers table:
# Exact taxonomy code
?primary_taxonomy_code=eq.207RC0000X
# Prefix match (all Internal Medicine subspecialties)
?primary_taxonomy_code=like.207R*
# Multiple specific codes
?primary_taxonomy_code=in.(207RC0000X,207RI0011X,207RG0100X)Combining with Other Filters
# Cardiologists in New York
?practice_state=eq.NY&primary_taxonomy_code=eq.207RC0000X&limit=20
# All physician specialties in Houston, TX
?practice_state=eq.TX&practice_city=eq.HOUSTON&primary_taxonomy_code=like.207*&entity_type=eq.1&limit=50
# Hospital organizations nationwide
?primary_taxonomy_code=eq.282N00000X&entity_type=eq.2&limit=50Provider Type Groups
The 873 taxonomy codes fall into these top-level provider type groups:
| Provider Type | Code Prefix Range | Description |
|---|---|---|
| Allopathic & Osteopathic Physicians | 207*, 208* | MDs and DOs across all specialties |
| Dental Providers | 122*, 124*, 126* | Dentists, dental hygienists, labs |
| Nursing Service Providers | 163*, 364*, 367* | RNs, LPNs, nurse aides |
| Advanced Practice Nurses | 363L*, 363A* | Nurse practitioners, clinical nurse specialists |
| Physician Assistants | 363A* | PAs in various specialties |
| Pharmacists & Pharmacies | 174*, 183*, 333* | Individual pharmacists and pharmacy organizations |
| Behavioral Health | 101*, 102*, 103*, 104* | Psychologists, social workers, counselors |
| Therapy Providers | 225*, 226*, 231*, 235* | Physical, occupational, speech therapy |
| Hospitals | 282*, 283*, 284*, 286* | Acute care, rehab, psychiatric, long-term care |
| Clinics/Centers | 261Q* | Ambulatory care clinics by specialty |
| Laboratories | 291*, 292* | Clinical and pathology labs |
| Agencies | 251* | Home health, hospice, nursing facility |
| Suppliers | 332*, 335* | Durable medical equipment, prosthetics |
| Transportation Services | 341*, 343*, 344* | Ambulance, bus, air transport |
| Student/Trainee | 390* | Student health practitioners |
| Technicians/Technologists | 246*, 247* | Radiology, pathology technicians |
Top Healthcare Specialties
These are the most common specialties by provider count:
Physicians (MDs/DOs)
| Taxonomy Code | Specialty | Example Query |
|---|---|---|
207Q00000X | Family Medicine | ?primary_taxonomy_code=eq.207Q00000X |
207R00000X | Internal Medicine | ?primary_taxonomy_code=eq.207R00000X |
207RC0000X | Cardiovascular Disease | ?primary_taxonomy_code=eq.207RC0000X |
207X00000X | Orthopedic Surgery | ?primary_taxonomy_code=eq.207X00000X |
208D00000X | General Practice | ?primary_taxonomy_code=eq.208D00000X |
207V00000X | Obstetrics & Gynecology | ?primary_taxonomy_code=eq.207V00000X |
207N00000X | Dermatology | ?primary_taxonomy_code=eq.207N00000X |
207T00000X | Neurological Surgery | ?primary_taxonomy_code=eq.207T00000X |
2084P0800X | Psychiatry | ?primary_taxonomy_code=eq.2084P0800X |
207Y00000X | Otolaryngology | ?primary_taxonomy_code=eq.207Y00000X |
207RG0100X | Gastroenterology | ?primary_taxonomy_code=eq.207RG0100X |
207RE0101X | Endocrinology | ?primary_taxonomy_code=eq.207RE0101X |
207RP1001X | Pulmonary Disease | ?primary_taxonomy_code=eq.207RP1001X |
207RH0003X | Hematology & Oncology | ?primary_taxonomy_code=eq.207RH0003X |
207RI0011X | Interventional Cardiology | ?primary_taxonomy_code=eq.207RI0011X |
Dental Providers
| Taxonomy Code | Specialty | Example Query |
|---|---|---|
1223G0001X | General Practice Dentistry | ?primary_taxonomy_code=eq.1223G0001X |
122300000X | Dentist | ?primary_taxonomy_code=eq.122300000X |
1223P0221X | Pediatric Dentistry | ?primary_taxonomy_code=eq.1223P0221X |
1223X0400X | Orthodontics | ?primary_taxonomy_code=eq.1223X0400X |
1223S0112X | Oral & Maxillofacial Surgery | ?primary_taxonomy_code=eq.1223S0112X |
1223E0200X | Endodontics | ?primary_taxonomy_code=eq.1223E0200X |
1223P0106X | Periodontics | ?primary_taxonomy_code=eq.1223P0106X |
Advanced Practice & Allied Health
| Taxonomy Code | Specialty | Example Query |
|---|---|---|
363L00000X | Nurse Practitioner | ?primary_taxonomy_code=eq.363L00000X |
363A00000X | Physician Assistant | ?primary_taxonomy_code=eq.363A00000X |
174400000X | Pharmacist | ?primary_taxonomy_code=eq.174400000X |
225100000X | Physical Therapist | ?primary_taxonomy_code=eq.225100000X |
225500000X | Respiratory Therapist | ?primary_taxonomy_code=eq.225500000X |
152W00000X | Optometrist | ?primary_taxonomy_code=eq.152W00000X |
156FX1800X | Optician | ?primary_taxonomy_code=eq.156FX1800X |
231H00000X | Audiologist | ?primary_taxonomy_code=eq.231H00000X |
235Z00000X | Speech-Language Pathologist | ?primary_taxonomy_code=eq.235Z00000X |
Behavioral Health
| Taxonomy Code | Specialty | Example Query |
|---|---|---|
104100000X | Social Worker | ?primary_taxonomy_code=eq.104100000X |
1041C0700X | Clinical Social Worker | ?primary_taxonomy_code=eq.1041C0700X |
101YM0800X | Mental Health Psychologist | ?primary_taxonomy_code=eq.101YM0800X |
101Y00000X | Counselor | ?primary_taxonomy_code=eq.101Y00000X |
103T00000X | Psychologist | ?primary_taxonomy_code=eq.103T00000X |
106H00000X | Marriage & Family Therapist | ?primary_taxonomy_code=eq.106H00000X |
Facilities & Organizations
| Taxonomy Code | Specialty | Example Query |
|---|---|---|
282N00000X | General Acute Care Hospital | ?primary_taxonomy_code=eq.282N00000X |
282NC0060X | Critical Access Hospital | ?primary_taxonomy_code=eq.282NC0060X |
283Q00000X | Psychiatric Hospital | ?primary_taxonomy_code=eq.283Q00000X |
261QM0801X | Mental Health Clinic | ?primary_taxonomy_code=eq.261QM0801X |
261QR0405X | Rehabilitation Clinic | ?primary_taxonomy_code=eq.261QR0405X |
261QU0200X | Urgent Care Clinic | ?primary_taxonomy_code=eq.261QU0200X |
314000000X | Skilled Nursing Facility | ?primary_taxonomy_code=eq.314000000X |
3336C0003X | Pharmacy | ?primary_taxonomy_code=eq.3336C0003X |
251E00000X | Home Health Agency | ?primary_taxonomy_code=eq.251E00000X |
251G00000X | Hospice | ?primary_taxonomy_code=eq.251G00000X |
Taxonomy Distribution
| Metric | Value |
|---|---|
| Total distinct codes | 873 |
| Providers with exactly 1 taxonomy | 81% |
| Providers with 2+ taxonomies | 19.1% (~1.73M) |
| Providers with 4+ taxonomies | 3.7% |
| Taxonomy fill rate | 100% (every active provider has at least one) |
The primary_taxonomy_code on npi_providers reflects each provider's self-designated primary specialty. Providers with multiple specialties have additional entries in the npi_taxonomies join table.
Example Queries
Find all nurse practitioners in California:
curl "https://newbizbot.ai/api/data/npi_providers?practice_state=eq.CA&primary_taxonomy_code=eq.363L00000X&entity_type=eq.1&limit=10" \
-H "Authorization: Bearer YOUR_API_KEY"Find hospitals in the Southeast:
curl "https://newbizbot.ai/api/data/npi_providers?practice_state=in.(GA,FL,NC,SC,AL,TN)&primary_taxonomy_code=eq.282N00000X&entity_type=eq.2&limit=50&select=npi,organization_name,practice_city,practice_state,primary_taxonomy_display" \
-H "Authorization: Bearer YOUR_API_KEY"Find all mental health providers in Chicago:
# Prefix match: all behavioral health codes start with 10
curl "https://newbizbot.ai/api/data/npi_providers?practice_state=eq.IL&practice_city=eq.CHICAGO&primary_taxonomy_code=like.10*&limit=50&select=npi,first_name,last_name,credential,primary_taxonomy_display" \
-H "Authorization: Bearer YOUR_API_KEY"Count pharmacists by state:
curl -I "https://newbizbot.ai/api/data/npi_providers?practice_state=eq.TX&primary_taxonomy_code=eq.174400000X&limit=0" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Prefer: count=exact"