Healthparse · Recipients 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/open-payments/recipients/search", {
  method: "GET",
});
const data = await res.json();

curl -X GET \
  "https://api.healthparse.io/v1/open-payments/recipients/search?performance_year=example&specialty=example&state=example" \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "performance_year": 2024,
  "records_notice": "Observational rollup of the CMS Open Payments (Sunshine Act) General Payments file, keyed on the recipient NPI. A row means a physician appears in the public federal payments file for the stated year — not a judgment about the provider. Name / specialty / state / city are resolved by joining the NPI to the CMS Part D Prescribers file (the Open Payments file carries none of them). Provider-level program data — not a consumer report, and not for FCRA-regulated eligibility decisions.",
  "rows": [
    {
      "nature_of_payment": "Consulting Fee",
      "npi": "1952964959",
      "prescriber_city": "San Pablo",
      "prescriber_name": "Roe, John",
      "prescriber_specialty": "Cardiology",
      "prescriber_state": "CA",
      "total_amount": 42500,
      "total_records": 18
    }
  ],
  "selectors": [
    "performance_year=2024",
    "state=CA",
    "specialty=Cardiology",
    "min_amount=1000"
  ],
  "total_matched": 1,
  "total_matched_capped": false
}