Api Endpoint

api.healthparse.io

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.

Open interactive test console

Offering

Provider: api.healthparse.io
Method: GET
Offering type: Api Endpoint
Transport type: http
Category: Health And Medicine
Delivery: Not provided
Pricing model: Not provided
x402 version: 2

Endpoint context

URL: https://api.healthparse.io/v1/prescribers/part-d/by-drug/search
MIME type: application/json
First seen: 2026-10-16T01:58:26.121Z
Last seen: 2026-11-01T20:33:26.802Z
Tags: None supplied

Website

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1: 0.03 USDC
Atomic price: 30000 · Network: eip155:8453 · Asset: USDC · Scheme: exact

Raw x402 terms

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "30000",
    "payTo": "0x177eA123A35253ba8869A7e21E717978e482351D"
  }
]

Observed health

Status: Healthy
Latest latency: 93 ms
Average latency: 853 ms
HTTP status: 402
Last checked: 2026-11-01T20:33:26.797Z
Reachability: 100% over 13 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "drug_class": {
      "type": "string",
      "description": "therapeutic class from partd_drug_class, e.g. 'GLP-1' | 'SGLT2' | 'DPP-4' | 'Statin'"
    },
    "drug": {
      "type": "string",
      "description": "a single drug, brand or generic (e.g. 'Ozempic' or 'Semaglutide'); brands resolve to the canonical generic"
    },
    "brand_name": {
      "type": "string",
      "description": "CMS brand-name prefix (case-insensitive), e.g. 'Eliquis'"
    },
    "generic_name": {
      "type": "string",
      "description": "CMS generic-name prefix (case-insensitive), e.g. 'Apixaban'"
    },
    "specialty": {
      "type": "string",
      "description": "prescriber specialty substring, e.g. 'Endocrinology'"
    },
    "state": {
      "type": "string",
      "description": "2-letter prescriber state code(s), comma-separated"
    },
    "min_claims": {
      "type": "integer",
      "description": "minimum total Part D claims for the drug (that year)"
    },
    "min_beneficiaries": {
      "type": "integer",
      "description": "minimum total beneficiaries (null/suppressed rows excluded)"
    },
    "year": {
      "type": "integer",
      "description": "performance year (loaded: 2023, 2024; default 2024)"
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "default": 25
    },
    "offset": {
      "type": "integer",
      "default": 0
    }
  }
}

Output schema

{
  "type": "json",
  "example": {
    "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.",
    "performance_year": 2024,
    "selectors": [
      "drug_class=GLP-1"
    ],
    "total_matched": 1,
    "rows": [
      {
        "npi": "1234567890",
        "performance_year": 2024,
        "brand_name": "Ozempic",
        "generic_name": "Semaglutide",
        "total_claims": 512,
        "total_30day_fills": 618.4,
        "total_drug_cost": 512340.11,
        "total_beneficiaries": 88,
        "prescriber_specialty": "Endocrinology",
        "prescriber_state": "TX",
        "prescriber_city": "Houston"
      }
    ]
  }
}