Taxonomy hierarchy
Exacthealthcare_taxonomy_hierarchyDeterministic and authoritative — the canonical answer for this input.
Return the three-level hierarchy walk for a NUCC taxonomy code: grouping (top), classification (middle), specialization (leaf). Useful for taxonomic breadcrumbs and UI drill-down. For children of a grouping/classification, use healthcare_taxonomy_list. Processing multiple inputs? Use `healthcare_taxonomy_hierarchy_batch` to do up to 1000 in one call.
Parameters
codestringrequiredNUCC provider taxonomy code.
Call it
curl -X POST https://api.snipget.ai/v1/healthcare/taxonomy/hierarchy \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"code":"207QA0000X"}'The Batch tab sends up to 1000 inputs in one call via /v1/healthcare/taxonomy/hierarchy/batch.
FAQ
What does the hierarchy give me?
For a NUCC code it returns the three-level walk: grouping (top), classification (middle), and specialization (leaf, which may be empty). It is handy for breadcrumbs and for showing where a specialty sits in the official tree.
Is this an exact answer?
Yes. It is a direct, deterministic lookup of the maintained taxonomy for that exact code, not an approximate match.
How is it different from list?
Hierarchy walks upward from one code to show its parents. List walks downward to enumerate the children under a grouping or classification. Use list to find 'all family medicine subspecialties'.
What if the code is unknown?
You get a not-found result for that code rather than an error, so a bad code is easy to handle in a batch.