OpenPayments

getTopPaymentRecipients

Free

Rank US clinicians by general payments (consulting, speaker fees, travel, food...) received in one program year from a company and/or for a drug/device. Core KOL-mapping tool: filter by nature of payment, state or specialty. Requires companyId or productName; productName-only queries scan the whole year and can take up to a minute, so pass companyId when known. Product matching uses the primary product of each payment.

Try it

Open in playground
kirha tools run openpayments_getTopPaymentRecipients \
  --input '{}'

Uses the key saved by kirha auth login.

  • companyIdstring, Matches ^\d+$

    From searchOpenPaymentsCompanies

  • limitinteger, default 20, 1 to 50
  • natureOfPaymentstring

    One of food_and_beverage, consulting_fee, speaker_fee_non_accredited, speaker_fee_accredited_education, travel_and_lodging, honoraria, education, grant, royalty_or_license, gift, entertainment, charitable_contribution, space_rental_or_facility_fees, long_term_device_loan, debt_forgiveness, acquisitions

  • productNamestring, At least 2 characters

    Exact brand/product name as reported, case-insensitive, e.g. Keytruda, Eliquis

  • programYearinteger, 2013 to 2100

    Program year. Defaults to the latest published year (CMS publishes each June).

  • specialtystring, At least 3 characters

    Substring of the NUCC taxonomy, e.g. Oncology

  • statestring, 2 to 2 characters

    US state code, e.g. TX