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

Works in any harness

Get your API key, then install with one command