Search Providers
GEThttps://api-healthcare-providers.dataandapis.com/v1/providers
Search Providers 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 | |
|---|---|---|
| city | Rochester | Optional |
| last_name | Optional | |
| limit | 20 | Optional |
| page | 1 | Optional |
| q | Mayo Clinic | Optional |
| specialty | Optional | |
| state | MN | Optional |
| taxonomy | Optional | |
| type | Optional | |
| zip | Optional |
Example request
curl
curl "https://api-healthcare-providers.dataandapis.com/v1/providers?city=Rochester&limit=20&page=1&q=Mayo%20Clinic&state=MN" \
-H "X-Api-Key: YOUR_API_KEY"Node.js
const res = await fetch("https://api-healthcare-providers.dataandapis.com/v1/providers?city=Rochester&limit=20&page=1&q=Mayo%20Clinic&state=MN", {
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/providers?city=Rochester&limit=20&page=1&q=Mayo%20Clinic&state=MN",
headers={"X-Api-Key": os.environ["DATAANDAPIS_KEY"]},
)
data = r.json()Example response
Example response{
"ok": true,
"total": 24,
"page": 1,
"limit": 20,
"count": 3,
"results": [
{
"npi": 1083249577,
"entity_type": "organization",
"name": "Mayo Clinic",
"credential": null,
"specialty": "Clinical Medical Laboratory",
"city": "Rochester",
"state": "MN"
},
{
"npi": 1114343860,
"entity_type": "organization",
"name": "Mayo Clinic",
"credential": null,
"specialty": "Infectious Disease Physician",
"city": "Rochester",
"state": "MN"
},
{
"npi": 1164758868,
"entity_type": "organization",
…
Show full response
Example response
{
"ok": true,
"total": 24,
"page": 1,
"limit": 20,
"count": 3,
"results": [
{
"npi": 1083249577,
"entity_type": "organization",
"name": "Mayo Clinic",
"credential": null,
"specialty": "Clinical Medical Laboratory",
"city": "Rochester",
"state": "MN"
},
{
"npi": 1114343860,
"entity_type": "organization",
"name": "Mayo Clinic",
"credential": null,
"specialty": "Infectious Disease Physician",
"city": "Rochester",
"state": "MN"
},
{
"npi": 1164758868,
"entity_type": "organization",
…{
"ok": true,
"total": 24,
"page": 1,
"limit": 20,
"count": 3,
"results": [
{
"npi": 1083249577,
"entity_type": "organization",
"name": "Mayo Clinic",
"credential": null,
"specialty": "Clinical Medical Laboratory",
"city": "Rochester",
"state": "MN"
},
{
"npi": 1114343860,
"entity_type": "organization",
"name": "Mayo Clinic",
"credential": null,
"specialty": "Infectious Disease Physician",
"city": "Rochester",
"state": "MN"
},
{
"npi": 1164758868,
"entity_type": "organization",
"name": "Mayo Clinic",
"credential": null,
"specialty": "Community Based Hospice Care Agency",
"city": "Rochester",
"state": "MN"
}
]
}