Taxonomy list
Exacthealthcare_taxonomy_listDeterministic and authoritative — the canonical answer for this input.
List active NUCC taxonomy rows under a grouping or classification filter. Matching is case-insensitive equality (not substring) — for free-text, use healthcare_taxonomy_search. At least one of `grouping` or `classification` is required. Use this to enumerate 'all physician types' or 'all family medicine subspecialties'. Processing multiple inputs? Use `healthcare_taxonomy_list_batch` to do up to 50 in one call.
Parameters
groupingstringoptionalExact grouping name to list children of.
classificationstringoptionalExact classification name to list children of.
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.
limitintegeroptionalCall it
curl -X POST https://api.snipget.ai/v1/healthcare/taxonomy/list \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"classification":"Family Medicine"}'The Batch tab sends up to 1000 inputs in one call via /v1/healthcare/taxonomy/list/batch.
FAQ
What is list good for?
Enumerating every active taxonomy row under a grouping or classification, for example all family medicine subspecialties or all physician types. It draws on the maintained NUCC dataset.
How do the filters work?
Provide a grouping or a classification (or both) as an exact, case-insensitive match. At least one is required. This is exact filtering, so the names must match the official values, not approximate text.
How do I find valid grouping or classification names?
Use the taxonomy groupings tool to list every valid grouping with its counts. That is the easiest way to discover the exact values to filter on.
What if I only have loose wording?
List will not fuzzy-match. For free-text like 'family doctor', use the taxonomy search tool instead, then list the children of the result.