Skip to main content
  • Dataset id: cms_opps_addenda
  • 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_opps_addenda in a search request. A filter not listed here, or a value of the wrong type, is a 400.
​
string
Exact HCPCS code, uppercase (e.g. “C1874”, “0071T”, “J9299”). Matches Addendum B rows only — Addendum A is APC-level and has no HCPCS code.
​
string
Exact APC (Ambulatory Payment Classification) number, e.g. “5414”. Matches the APC’s own Addendum A row and every Addendum B code assigned to it.
​
string
“A” for APC-level payment rows, “B” for HCPCS-code-level rows. Omit to search both.Values: A, B.
​
string
Exact quarter label, “yearQn” (e.g. “2026Q2” = the April 2026 release). Omit to search every ingested quarter.
​
string
Exact OPPS status indicator (e.g. “J1”, “N”, “T”, “S”, “E1”, “C”, “K”, “G”). Case-sensitive, uppercase.
​
string
“I” = CPT/Level I (digit-leading, descriptor withheld), “II” = HCPCS Level II (letter-leading, descriptor present).Values: I, II.
​
string
BM25 keyword match on the short descriptor (Addendum B) or APC group title (Addendum A), e.g. “brachytherapy source”. Only matches rows whose descriptor is not copyright-withheld.
​
string
BM25 keyword match on the official status-indicator definition text from OPPS Addendum D1 (e.g. “separately payable”, “packaged”, “inpatient only”, “pass-through”).
​
integer
Exact calendar year of the quarter (e.g. 2026).
​
integer
Inclusive lower bound on the quarter’s year.
​
integer
Inclusive upper bound on the quarter’s year.
​
number
Inclusive lower bound on the national unadjusted payment rate in dollars (e.g. 1000 for rates of $1,000+). Rows with no payment rate are excluded.
​
number
Inclusive upper bound on the national unadjusted payment rate in dollars. Rows with no payment rate are excluded.

​
Fields

Each result from this dataset has these in fields: addendum, adjusted_beneficiary_copayment, apc, changed_flag, code_level, descriptor, descriptor_withheld, effective_date, hcpcs_code, id, ira_coinsurance_pct, minimum_unadjusted_copayment, national_unadjusted_copayment, note, pass_through_expiring, payment_rate, quarter, relative_weight, revision_date, status_indicator, status_indicator_desc, url, year