# CMS Open Payments research payments · Top

Get health and medical data with CMS Open Payments research payments · Top from Alexandria through one Spiral API key. For "which manufacturers paid MD Anderson the most for research", "which investigators did AstraZeneca fund most", "which sites got the most for study X" or "which products drew the most research funding". Payments of several investigators or products count once, under the first one named. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: Health
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `openpaymentsdata-cms-gov/research-payments/top`
- Page: https://spiral.ai/tools/alexandria/openpaymentsdata-cms-gov/research-payments/top

## Pricing

$0.00873 per call.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `group_by` (required) | one of | manufacturer, recipient, investigator, study, product | — | What to total by: the paying `manufacturer`; the `recipient` (teaching hospital, institution or practitioner paid); the first principal `investigator`; the `study` (name and ClinicalTrials.gov ID, with its sponsor); or the first `product` (with its sponsor). |
| `site` | text |  | — | Where the research was paid: a teaching hospital's 6-character CMS Certification Number (`450076`), or words matched case-insensitively anywhere in the teaching hospital or non-covered recipient entity name (`MD Anderson` matches both `Ut Md Anderson Cancer Center` and `MD ANDERSON CANCER CENTER UNIVERSITY OF TEXAS`). Sites are named as each manufacturer reported them, so try a short distinctive name. |
| `limit` | number | 1 to 100 | 25 | Most results to return. |
| `state` | text |  | — | Two-letter US state or territory code of the recipient (`TX`). Pattern: ^\s*[A-Za-z]{2}\s*$. |
| `study` | text |  | — | Words matched case-insensitively anywhere in the study name as the manufacturer reported it (`ARTEMIDE-Lung04`, `asciminib`). Many manufacturers write the protocol title, some only a protocol number. |
| `nct_id` | text |  | — | A ClinicalTrials.gov ID (`NCT06868277`), matched against the reported ClinicalTrials.gov identifier or anywhere in the study name. Manufacturers often leave the identifier blank, so no match does not mean the trial has no payments; search `study` with the trial's acronym too. Pattern: ^\s*[Nn][Cc][Tt][0-9]{8}\s*$. |
| `offset` | number | 0 to 1000 | 0 | Results to skip; pass `next_offset` from the previous page. |
| `product` | text |  | — | Words matched case-insensitively in any of the five product names (drug, biological, device or supply) on the payment (`Imfinzi`, `durvalumab`). Products are named as reported, often by brand. |
| `max_amount` | number | 0 to 10000000000 | — | Largest payment amount in USD, inclusive. |
| `min_amount` | number | 0 to 10000000000 | — | Smallest payment amount in USD, inclusive. |
| `investigator` | text |  | — | A person on the payment: a 10-digit NPI, a last name (`Jabbour`), or a first and last name (`Elias Jabbour`, `Jabbour, Elias`). Matched against the five principal investigator slots and the physician or practitioner paid directly; the last name exactly (case-insensitive), the first name as a prefix (`Eli` matches ELIAS). Suffixes such as Jr, III, MD or PhD are dropped. |
| `manufacturer` | text |  | — | The reporting entity (manufacturer or GPO) that made the payment: CMS's 12-digit ID (`100000000146`), or words matched case-insensitively anywhere in an entity's current or former names in CMS's reporting entity profile (`AstraZeneca` matches AstraZeneca Pharmaceuticals LP, AstraZeneca AB and AstraZeneca UK Limited). `manufacturers_matched` lists the entities used. More than 100 matches is invalid_input. |
| `program_year` | number | 2013 to 2100 | — | Program year, the calendar year the payments were made. Defaults to the latest year CMS has published (2025, published June 30, 2026). CMS keeps the latest seven years online, 2019 to 2025 now; each is its own dataset, so a call covers one year. |
| `therapeutic_area` | text |  | — | Words matched case-insensitively in any product's category or therapeutic area (`oncology`). |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "openpaymentsdata-cms-gov/research-payments/top",
    "input": {
      "group_by": "manufacturer"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=openpaymentsdata-cms-gov%2Fresearch-payments%2Ftop

## Common questions

### CMS Open Payments research payments · Top

**How much does CMS Open Payments research payments · Top cost?**

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use CMS Open Payments research payments · Top through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "openpaymentsdata-cms-gov/research-payments/top"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use CMS Open Payments research payments · Top?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use CMS Open Payments research payments · Top?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

