Random Providers
GEThttps://api-healthcare-providers.dataandapis.com/v1/providers/random
Random 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 | |
|---|---|---|
| amount | 3 | Optional |
Example request
curl
curl "https://api-healthcare-providers.dataandapis.com/v1/providers/random?amount=3" \
-H "X-Api-Key: YOUR_API_KEY"Node.js
const res = await fetch("https://api-healthcare-providers.dataandapis.com/v1/providers/random?amount=3", {
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/random?amount=3",
headers={"X-Api-Key": os.environ["DATAANDAPIS_KEY"]},
)
data = r.json()Example response
Example response{
"ok": true,
"count": 1,
"results": [
{
"npi": 1417000100,
"entity_type": "individual",
"name": "Alvin Bryan",
"first_name": "Alvin",
"last_name": "Bryan",
"credential": "MD",
"gender": "M",
"organization_other_name": null,
"sole_proprietor": false,
"specialty": "Anatomic Pathology & Clinical Pathology Physician",
"taxonomies": [
{
"code": "207ZP0102X",
"primary": true,
"specialty": "Anatomic Pathology & Clinical Pathology Physician",
"grouping": "Allopathic & Osteopathic Physicians"
}
],
"practice_location": {
"street": "1520 N Leg Rd",
"city": "Augusta",
"state": "GA",
"zip": "30909",
…
Show full response
Example response
{
"ok": true,
"count": 1,
"results": [
{
"npi": 1417000100,
"entity_type": "individual",
"name": "Alvin Bryan",
"first_name": "Alvin",
"last_name": "Bryan",
"credential": "MD",
"gender": "M",
"organization_other_name": null,
"sole_proprietor": false,
"specialty": "Anatomic Pathology & Clinical Pathology Physician",
"taxonomies": [
{
"code": "207ZP0102X",
"primary": true,
"specialty": "Anatomic Pathology & Clinical Pathology Physician",
"grouping": "Allopathic & Osteopathic Physicians"
}
],
"practice_location": {
"street": "1520 N Leg Rd",
"city": "Augusta",
"state": "GA",
"zip": "30909",
…{
"ok": true,
"count": 1,
"results": [
{
"npi": 1417000100,
"entity_type": "individual",
"name": "Alvin Bryan",
"first_name": "Alvin",
"last_name": "Bryan",
"credential": "MD",
"gender": "M",
"organization_other_name": null,
"sole_proprietor": false,
"specialty": "Anatomic Pathology & Clinical Pathology Physician",
"taxonomies": [
{
"code": "207ZP0102X",
"primary": true,
"specialty": "Anatomic Pathology & Clinical Pathology Physician",
"grouping": "Allopathic & Osteopathic Physicians"
}
],
"practice_location": {
"street": "1520 N Leg Rd",
"city": "Augusta",
"state": "GA",
"zip": "30909",
"country": "US",
"phone": "(706) 869-3121"
},
"enumeration_date": "2007-01-18",
"last_updated": "2015-08-05"
}
]
}