Search Taxonomies
GEThttps://api-healthcare-providers.dataandapis.com/v1/taxonomies
Search Taxonomies is an endpoint of the Healthcare Providers API. Look up any of 9.37 million US NPIs with specialties resolved to plain names.
Send your key in the X-Api-Key header. Each call costs 1 token; a free key includes 500 tokens a month.
Request
Query parameters
| Parameter | Example | |
|---|---|---|
| limit | 50 | Optional |
| q | orthopaedic | Optional |
| section | Individual | Optional |
Example request
curl
curl "https://api-healthcare-providers.dataandapis.com/v1/taxonomies?limit=50&q=orthopaedic§ion=Individual" \
-H "X-Api-Key: YOUR_API_KEY"Node.js
const res = await fetch("https://api-healthcare-providers.dataandapis.com/v1/taxonomies?limit=50&q=orthopaedic§ion=Individual", {
headers: { "X-Api-Key": process.env.DATAANDAPIS_KEY },
});
const data = await res.json();Python
import os, requests
r = requests.get(
"https://api-healthcare-providers.dataandapis.com/v1/taxonomies?limit=50&q=orthopaedic§ion=Individual",
headers={"X-Api-Key": os.environ["DATAANDAPIS_KEY"]},
)
data = r.json()Example response
Example response{
"ok": true,
"count": 3,
"taxonomies": [
{
"code": "207X00000X",
"grouping": "Allopathic & Osteopathic Physicians",
"classification": "Orthopaedic Surgery",
"specialization": null,
"display_name": "Orthopaedic Surgery Physician",
"section": "Individual"
},
{
"code": "207XS0114X",
"grouping": "Allopathic & Osteopathic Physicians",
"classification": "Orthopaedic Surgery",
"specialization": "Adult Reconstructive Orthopaedic Surgery",
"display_name": "Adult Reconstructive Orthopaedic Surgery Physician",
"section": "Individual"
},
{
"code": "207XX0004X",
"grouping": "Allopathic & Osteopathic Physicians",
"classification": "Orthopaedic Surgery",
"specialization": "Foot and Ankle Surgery",
"display_name": "Orthopaedic Foot and Ankle Surgery Physician",
"section": "Individual"
}
…
Show full response
Example response
{
"ok": true,
"count": 3,
"taxonomies": [
{
"code": "207X00000X",
"grouping": "Allopathic & Osteopathic Physicians",
"classification": "Orthopaedic Surgery",
"specialization": null,
"display_name": "Orthopaedic Surgery Physician",
"section": "Individual"
},
{
"code": "207XS0114X",
"grouping": "Allopathic & Osteopathic Physicians",
"classification": "Orthopaedic Surgery",
"specialization": "Adult Reconstructive Orthopaedic Surgery",
"display_name": "Adult Reconstructive Orthopaedic Surgery Physician",
"section": "Individual"
},
{
"code": "207XX0004X",
"grouping": "Allopathic & Osteopathic Physicians",
"classification": "Orthopaedic Surgery",
"specialization": "Foot and Ankle Surgery",
"display_name": "Orthopaedic Foot and Ankle Surgery Physician",
"section": "Individual"
}
…{
"ok": true,
"count": 3,
"taxonomies": [
{
"code": "207X00000X",
"grouping": "Allopathic & Osteopathic Physicians",
"classification": "Orthopaedic Surgery",
"specialization": null,
"display_name": "Orthopaedic Surgery Physician",
"section": "Individual"
},
{
"code": "207XS0114X",
"grouping": "Allopathic & Osteopathic Physicians",
"classification": "Orthopaedic Surgery",
"specialization": "Adult Reconstructive Orthopaedic Surgery",
"display_name": "Adult Reconstructive Orthopaedic Surgery Physician",
"section": "Individual"
},
{
"code": "207XX0004X",
"grouping": "Allopathic & Osteopathic Physicians",
"classification": "Orthopaedic Surgery",
"specialization": "Foot and Ankle Surgery",
"display_name": "Orthopaedic Foot and Ankle Surgery Physician",
"section": "Individual"
}
]
}