Healthparse · Lookup Search

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://api.healthparse.io/v1/prescribers/lookup/search", {
  method: "GET",
});
const data = await res.json();

curl -X GET \
  "https://api.healthparse.io/v1/prescribers/lookup/search?name=example&npi=example&state=example" \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "field_visibility": {
    "gated": [
      "has_part_d",
      "total_part_d_claims",
      "distinct_drugs",
      "beneficiaries",
      "top_drug_claims",
      "writes_glp1",
      "writes_sglt2",
      "writes_dpp4",
      "writes_statin",
      "drug_classes_written",
      "new_to_class",
      "latest_year"
    ],
    "teaser": [
      "npi",
      "prescriber_name",
      "specialty",
      "state",
      "city",
      "top_drug",
      "total_drug_classes_tracked"
    ]
  },
  "latest_year": 2024,
  "records_notice": "Prescriber identity from the public NPPES provider directory joined to that NPI's Medicare Part D prescribing as published in the CMS 'by Provider and Drug' public file. Part D figures are for the latest loaded year (PY2024); 'beneficiaries' is the largest per-drug beneficiary count CMS publishes for the prescriber and is typically null in the current load (the by-drug file suppresses beneficiary counts below 11). Absence of Part D rows means no Medicare Part D activity was published for that NPI — not that the provider does not prescribe. Provider-level program data — not a consumer report, and not for FCRA-regulated eligibility decisions.",
  "rows": [
    {
      "beneficiaries": null,
      "city": "San Pablo",
      "distinct_drugs": 28,
      "drug_classes_written": [
        "GLP-1",
        "Statin"
      ],
      "has_part_d": true,
      "latest_year": 2024,
      "new_to_class": false,
      "npi": "1952964959",
      "prescriber_name": "Aarentino Smith",
      "specialty": "Nurse Practitioner",
      "state": "CA",
      "top_drug": "Atorvastatin Calcium",
      "top_drug_claims": 398,
      "total_drug_classes_tracked": 2,
      "total_part_d_claims": 1447,
      "writes_dpp4": false,
      "writes_glp1": true,
      "writes_sglt2": false,
      "writes_statin": true
    }
  ],
  "selectors": [
    "name=smith"
  ],
  "total_matched": 1
}