Reference Data

Provider Taxonomy Codes

Access the complete NUCC Health Care Provider Taxonomy code set with classifications, specializations, and hierarchical relationships.

Get Taxonomy Code

GET/v1/taxonomy/{code}

curl -X GET "https://api.medref.io/v1/taxonomy/207R00000X" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "code": "207R00000X",
  "type": "Individual",
  "classification": "Internal Medicine",
  "specialization": null,
  "definition": "A physician who provides long-term, comprehensive care...",
  "grouping": "Allopathic & Osteopathic Physicians",
  "display_name": "Internal Medicine Physician",
  "section": "Individual Health Care Providers",
  "hierarchy": {
    "level": 2,
    "parent": "207R",
    "children": [
      {
        "code": "207RA0000X",
        "specialization": "Adolescent Medicine"
      },
      {
        "code": "207RC0000X",
        "specialization": "Cardiovascular Disease"
      },
      {
        "code": "207RE0101X",
        "specialization": "Endocrinology, Diabetes & Metabolism"
      }
    ]
  },
  "effective_date": "2024-07-01",
  "version": "24.1"
}

Search Taxonomies

GET/v1/taxonomy/search

curl -X GET "https://api.medref.io/v1/taxonomy/search?q=cardiology&type=individual" \
  -H "Authorization: Bearer YOUR_API_KEY"

Query Parameters

Parameter	Type	Description
q	string	Search term for classification or specialization
type	string	individual, group, or non-individual
grouping	string	Filter by taxonomy grouping

Browse Hierarchy

Navigate the taxonomy hierarchy by section or grouping.

GET/v1/taxonomy/hierarchy

curl -X GET "https://api.medref.io/v1/taxonomy/hierarchy?section=individual" \
  -H "Authorization: Bearer YOUR_API_KEY"

// Returns full tree structure of taxonomy groupings and classifications

Taxonomy Sections

Section	Description
Individual	Physicians, dentists, therapists, etc.
Group	Multi-provider groups and practices
Non-Individual	Hospitals, labs, agencies, suppliers