Find Medicare Part D prescribers of a specific DRUG or therapeutic CLASS at NPI level — th
Find Medicare Part D prescribers of a specific DRUG or therapeutic CLASS at NPI level — the core pharma targeting query. Filter by drug_class (GLP-1, SGLT2, DPP-4, Statin, from partd_drug_class) or a single drug (brand or generic, e.g. 'Ozempic'), plus specialty, state, min_claims, min_beneficiaries, year. Each hit carries the drug's claim/cost volume and the prescriber's specialty/state/city. Public CMS provider-level data; not a consumer report.
30000 (raw units)
price
1
calls / 30d
1
unique payers
2026-09-07
updated
Provider
api.healthparse.io · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0x177eA123A35253ba8869A7e21E717978e482351D",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "30000",
"maxTimeoutSeconds": 300
}
]Output schema
{
"bazaar": {
"info": {
"input": {
"method": "GET",
"queryParams": {
"brand_name": "example",
"drug": "example",
"drug_class": "example"
},
"type": "http"
},
"output": {
"example": {
"performance_year": 2024,
"records_notice": "Observational roster of Medicare Part D prescribers for the requested drug or therapeutic class, as published in the CMS 'by Provider and Drug' public file. One row per (NPI × drug) for the performance year; total_beneficiaries is null where CMS suppressed a count below 11. prescriber_specialty/state/city are the values filed on the CMS record. Provider-level program data — not a consumer report, and not for FCRA-regulated eligibility decisions.",
"rows": [
{
"brand_name": "Ozempic",
"generic_name": "Semaglutide",
"npi": "1234567890",
"performance_year": 2024,
"prescriber_city": "Houston",
"prescriber_specialty": "Endocrinology",
"prescriber_state": "TX",
"total_30day_fills": 618.4,
"total_beneficiaries": 88,
"total_claims": 512,
"total_drug_cost": 512340.11
}
],
"selectors": [
"drug_class=GLP-1"
],
"total_matched": 1
},
"type": "json"
}
},
"routeTemplate": "/v1/prescribers/part-d/by-drug/search",
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"properties": {
"brand_name": {
"description": "CMS brand-name prefix (case-insensitive), e.g. 'Eliquis'",
"type": "string"
},
"drug": {
"description": "a single drug, brand or generic (e.g. 'Ozempic' or 'Semaglutide'); brands resolve to the canonical generic",
"type": "string"
},
"drug_class": {
"description": "therapeutic class from partd_drug_class, e.g. 'GLP-1' | 'SGLT2' | 'DPP-4' | 'Statin'",
"type": "string"
},
"generic_name": {
"description": "CMS generic-name prefix (case-insensitive), e.g. 'Apixaban'",
"type": "string"
},
"limit": {
"default": 25,
"maximum": 100,
"type": "integer"
},
"min_beneficiaries": {
"description": "minimum total beneficiaries (null/suppressed rows excluded)",
"type": "integer"
},
"min_claims": {
"description": "minimum total Part D claims for the drug (that year)",
"type": "integer"
},
"offset": {
"default": 0,
"type": "integer"
},
"specialty": {
"description": "prescriber specialty substring, e.g. 'Endocrinology'",
"type": "string"
},
"state": {
"description": "2-letter prescriber state code(s), comma-separated",
"type": "string"
},
"year": {
"description": "performance year (loaded: 2023, 2024; default 2024)",
"type": "integer"
}
},
"type": "object"
}
},
"type": "object"
}
}
}Use it
curl
curl "https://api.healthparse.io/v1/prescribers/part-d/by-drug/search" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://api.healthparse.io/v1/prescribers/part-d/by-drug/search");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://api.healthparse.io/v1/prescribers/part-d/by-drug/search")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/14915.json, and this resource appears in /discovery/resources and /discovery/search.