> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rhizomeai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CMS Medicare Part B Drug Spending

> Search filters and result fields of cms_part_b_drug.

* **Dataset id:** `cms_part_b_drug`
* **Jurisdiction:** US · CMS
* **Date field:** none. A search that sets `date_from` or `date_to` skips this dataset and reports it as `skipped`.
* **Access:** any API key.

## Filters

Send these under `filters.cms_part_b_drug` in a [search](/api-reference/v3/search) request. A filter not listed here, or a value of the wrong type, is a 400.

<ParamField body="hcpcs_code" type="string">
  Exact HCPCS/J-code, uppercase (e.g. "J3241"). The primary identifier for a Part B drug across all its year rows.
</ParamField>

<ParamField body="brand_name" type="string">
  BM25 keyword match on the brand name (e.g. "Tepezza").
</ParamField>

<ParamField body="generic_name" type="string">
  BM25 keyword match on the generic name (e.g. "teprotumumab"). CMS generic names may carry a biosimilar suffix ("teprotumumab-trbw").
</ParamField>

<ParamField body="drug_description" type="string">
  BM25 keyword match on the HCPCS descriptor text (e.g. "injection teprotumumab 10 mg").
</ParamField>

<ParamField body="manufacturer" type="string">
  BM25 keyword match on the manufacturer/labeler name (e.g. "Amgen"), rolled up from the NDC-HCPCS crosswalk. A J-code can span several manufacturers (biosimilars).
</ParamField>

<ParamField body="application_number" type="string">
  Exact FDA application number in openFDA form, prefix + digits (e.g. "BLA761143", "NDA021436", "ANDA210016"). Matches any HCPCS whose application\_numbers roll-up contains it.
</ParamField>

<ParamField body="year" type="integer">
  Exact spending calendar year (e.g. 2024).
</ParamField>

<ParamField body="year_from" type="integer">
  Inclusive lower bound on the spending year.
</ParamField>

<ParamField body="year_to" type="integer">
  Inclusive upper bound on the spending year.
</ParamField>

<ParamField body="matched_app_in_corpus" type="boolean">
  True to keep only drugs with at least one linked application number indexed in the Rhizome FDA corpus.
</ParamField>

## Fields

Each result from this dataset has these in `fields`:

`annual_change_pct`, `application_numbers`, `avg_asp_price`, `avg_spending_per_beneficiary`, `avg_spending_per_claim`, `avg_spending_per_dosage_unit`, `brand_name`, `cagr_pct`, `current_asp_payment_limit`, `current_asp_quarter`, `generic_name`, `hcpcs_code`, `hcpcs_description`, `id`, `manufacturers`, `matched_app_in_corpus`, `outlier_flag`, `total_beneficiaries`, `total_claims`, `total_dosage_units`, `total_spending`, `url`, `year`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.