Look up an NUCC taxonomy by code
Exacthealthcare_taxonomy_lookupDeterministic and authoritative — the canonical answer for this input.
Look up a single NUCC provider taxonomy code (e.g. '207Q00000X'). Returns grouping (top level, e.g. 'Allopathic & Osteopathic Physicians'), classification (middle, e.g. 'Family Medicine'), specialization (leaf, e.g. 'Adolescent Medicine', may be null), definition, notes, display_name, and section ('Individual' vs 'Group'). Use `fields` to restrict the response. Every response includes `result.dataset` with the currently-served NUCC version. Returns `found: false` with confidence 0.0 when the code does not exist in the active dataset. Processing multiple inputs? Use `healthcare_taxonomy_lookup_batch` to do up to 1000 in one call.
Parameters
codestringrequiredNUCC provider taxonomy code (e.g. '207Q00000X').
fieldsarrayoptionalOptional list of fields to return per row. Defaults to all. Valid fields: code, grouping, classification, specialization, definition, notes, display_name, section. The 'code' field is always returned.
Call it
curl -X POST https://api.snipget.ai/v1/healthcare/taxonomy/lookup \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"code":"207Q00000X"}'The Batch tab sends up to 1000 inputs in one call via /v1/healthcare/taxonomy/lookup/batch.
FAQ
Why use this instead of memorizing taxonomy codes?
NUCC provider taxonomy codes map to specialties, and the official list is large and updated on a schedule. This returns the full maintained record for a code so you are not guessing at what '207Q00000X' means.
What comes back for a code?
The grouping (top level), classification (middle), specialization (leaf, which may be empty), the definition, notes, a clean display name, and the dataset version it came from. The answer is the exact, authoritative row for that code.
Can I narrow the response?
Yes. Pass a 'fields' list to return just the columns you need, for example only the display name. The code is always included.
What if I only know the specialty name, not the code?
Use the taxonomy search tool, which matches free text like 'family medicine'. Lookup needs the exact code, and an unknown code returns a not-found result.