cms R Package: Tools for Calculating CMS Medicare Reimbursement

Travis build status AppVeyor build status

License: GPL v3 CRAN version CRAN Downloads


The cms R package uses the CMS (Center for Medicare & Medicaid Services) API to provide useRs access to databases containing annually-updated Medicare reimbursement rates. Data is available for all localities in the United States. Currently, support is only provided for the Medicare Physician Fee Schedule (MPFS), but support will be expanded for other CMS databases in future versions. In summary, cms implements programmatic access to healthcare reimbursement data via the CMS API and the R programming language.


To install cms, run the following R code:

# install from CRAN

# install development version from GitHub

# install development version with vignettes
devtools::install_github("subramv/cms", build_vignettes = TRUE)

Sample code

The following code pulls the 2019 MPFS national payment file for all localities:

# load cms

#pull MPFS national payment file
mpfs19 <- get_mpfs(19)

More details can be found in the package vignettes.


cms is designed to automate import and cleaning of CMS publically-available databases for useRs to use. Databases are downloaded to a user-specified directory and by default are stored as compressed source files for re-use. At present, this functionality has been implemented for the MPFS.


Please report any bugs, suggestions, etc. on the issues page of the cms GitHub repository. Contributions (bug fixes, new features, etc.) are welcome via pull requests (generally from forked repositories).