Cms Open Payments Tools#

Configuration File: cms_open_payments_tools.json Tool Type: Local Tools Count: 1

This page contains all tools defined in the cms_open_payments_tools.json configuration file.

Available Tools#

CMSOpenPayments_search_payments (Type: CMSOpenPaymentsTool)#

Search CMS Open Payments (the ‘Sunshine Act’ database) for payments and transfers of value from d…

CMSOpenPayments_search_payments tool specification

Tool Information:

  • Name: CMSOpenPayments_search_payments

  • Type: CMSOpenPaymentsTool

  • Description: Search CMS Open Payments (the ‘Sunshine Act’ database) for payments and transfers of value from drug/device manufacturers to a US physician or teaching hospital, or all payments made by a manufacturer, for one program year (2019-2025, default 2024). Provide exactly one identifying filter. npi and manufacturer_id are indexed and fast (1-3s); recipient_last_name and manufacturer_name are exact-match only and take roughly 25s. Example: npi=’1528271848’ returns that physician’s itemized payments with company, amount, date, and associated drug/device.

Parameters:

  • npi ([‘string’, ‘null’]) (optional) Recipient’s National Provider Identifier, e.g. ‘1528271848’. Fast, indexed.

  • recipient_last_name ([‘string’, ‘null’]) (optional) Recipient’s exact last name, e.g. ‘Smith’. Slow (~25s), not indexed; prefer npi when known.

  • manufacturer_id ([‘string’, ‘null’]) (optional) Manufacturer/GPO’s Open Payments id, e.g. ‘100000010419’. Fast, indexed.

  • manufacturer_name ([‘string’, ‘null’]) (optional) Manufacturer’s exact registered name, e.g. ‘Phadia US Inc.’. Slow (~25s), not indexed; prefer manufacturer_id when known.

  • program_year ([‘integer’, ‘null’]) (optional) Program year, 2019-2025. Default 2024.

  • limit ([‘integer’, ‘null’]) (optional) Max payment records to return, 1-100. Default 25.

Example Usage:

query = {
    "name": "CMSOpenPayments_search_payments",
    "arguments": {
    }
}
result = tu.run(query)