Tidy Healthcare Provider API Interface
You can install provider from GitHub with:
# install.packages("pak")
pak::pak("andrewallenbruce/provider")The provider package is a high-level interface designed to streamline
access to publicly available healthcare provider data from the Centers
for Medicare and Medicaid Services (CMS) and other federal sources. It
provides a unified, tidy framework for querying complex datasets that
are essential for medical coding, billing, and healthcare revenue cycle
management.
Most functions in provider follow a similar pattern: they accept
identifiers (like an npi) or search criteria (like an org_name) and
return a tibble.
library(provider)affiliations(last = "Bruce")
✔ affiliations returned 328 results.
# A tibble: 328 × 8
first last middle npi pac prov_type prov_ccn parent_ccn
<chr> <chr> <chr> <int> <chr> <chr> <chr> <chr>
1 SIDNEY BRUCE D 1003044520 2466795406 Hospital 150173 <NA>
2 SIDNEY BRUCE D 1003044520 2466795406 Hospital 151312 <NA>
3 SIDNEY BRUCE D 1003044520 2466795406 Hospital 151316 <NA>
4 MARGARET BRUCE E 1003444332 0840619235 Hospital 500016 <NA>
5 LAUREN BRUCE C 1003863192 4385530377 Hospital 390331 <NA>
6 TIMOTHY BRUCE <NA> 1013228907 7315239902 Hospital 520008 <NA>
7 SARAH BRUCE <NA> 1023571882 8224498597 Hospital 390111 <NA>
8 SARAH BRUCE <NA> 1023571882 8224498597 Hospital 450018 <NA>
9 DAVID BRUCE S 1043213069 6406929694 Hospital 190036 <NA>
10 DAVID BRUCE <NA> 1043634017 0840422127 Hospital 110107 <NA>
# ℹ 318 more rowsreassignments(
state = "GA",
employers = greater(40, equal = TRUE))
✔ reassignments returned 86 results.
# A tibble: 86 × 13
first last state specialty employers npi pac enid org_name employees
<chr> <chr> <chr> <chr> <int> <int> <chr> <chr> <chr> <int>
1 Naushe… Nave… GA Diagnost… 42 1.51e9 8022… I201… Advance… 1
2 Naushe… Nave… GA Diagnost… 42 1.51e9 8022… I201… Atlanti… 40
3 Naushe… Nave… GA Diagnost… 42 1.51e9 8022… I201… Brooks … 48
4 Naushe… Nave… GA Diagnost… 42 1.51e9 8022… I201… Central… 34
5 Naushe… Nave… GA Diagnost… 42 1.51e9 8022… I201… Concord… 4
6 Naushe… Nave… GA Diagnost… 42 1.51e9 8022… I201… Crouse … 6
7 Naushe… Nave… GA Diagnost… 42 1.51e9 8022… I201… Diagnos… 19
8 Naushe… Nave… GA Diagnost… 42 1.51e9 8022… I201… Donalso… 101
9 Naushe… Nave… GA Diagnost… 42 1.51e9 8022… I201… Englewo… 1
10 Naushe… Nave… GA Diagnost… 42 1.51e9 8022… I201… Fred Sm… 6
# ℹ 76 more rows
# ℹ 3 more variables: org_pac <chr>, org_enid <chr>, org_state <chr>revocations(
state = "GA",
org_name = not_blank())
✔ revocations returned 115 results.
# A tibble: 115 × 12
org_name first middle last enid npi multi state prov_desc reason
<chr> <chr> <chr> <chr> <chr> <int> <int> <chr> <chr> <chr>
1 EMMANUEL O SOY… <NA> <NA> <NA> O200… 1.34e9 0 GA PART B S… 424.5…
2 COMPREHENSIVE … <NA> <NA> <NA> O200… 1.13e9 0 GA PART B S… 424.5…
3 RIVERSIDE FAMI… <NA> <NA> <NA> O200… 1.31e9 0 GA PART B S… 424.5…
4 PAIN MANAGEMEN… <NA> <NA> <NA> O200… 1.54e9 0 GA PART B S… 424.5…
5 DEEP SOUTH AMB… <NA> <NA> <NA> O200… 1.07e9 0 GA PART B S… 424.5…
6 SIGHT SAVERS E… <NA> <NA> <NA> O200… NA 0 GA PART B S… 424.5…
7 SENIOR PSYCH S… <NA> <NA> <NA> O200… 1.23e9 0 GA PART B S… 424.5…
8 WALLACE STEVE … <NA> <NA> <NA> O200… 1.98e9 0 GA PART B S… 424.5…
9 FULGHUM DRUGS … <NA> <NA> <NA> O200… 1.41e9 1 GA PART B S… 424.5…
10 AGAPE PRESCRIP… <NA> <NA> <NA> O200… 1.47e9 0 GA PART B S… 424.5…
# ℹ 105 more rows
# ℹ 2 more variables: start_date <date>, end_date <date>clinicians(
state = "GA",
school = not("OTHER"),
org_name = not_blank(),
grad_year = 2025)
✔ clinicians returned 144 results.
# A tibble: 144 × 18
first middle last gender cred school grad_year specialty npi pac enid
<chr> <chr> <chr> <chr> <chr> <chr> <int> <chr> <int> <chr> <chr>
1 ISAI… ANTON… BOYD M <NA> MERCE… 2025 PHYSICIA… 1.01e9 0042… I202…
2 EMILY <NA> HAUG… F PA MERCE… 2025 PHYSICIA… 1.02e9 5496… I202…
3 MADI… <NA> THUR… F OD ILLIN… 2025 OPHTHALM… 1.02e9 2567… I202…
4 MADI… <NA> THUR… F OD ILLIN… 2025 OPHTHALM… 1.02e9 2567… I202…
5 MARA S. DETR… F <NA> MERCE… 2025 PHYSICIA… 1.02e9 2264… I202…
6 BRIT… MARIE STEN… F <NA> MERCE… 2025 PHYSICIA… 1.04e9 7214… I202…
7 BRIT… MARIE STEN… F <NA> MERCE… 2025 PHYSICIA… 1.04e9 7214… I202…
8 BRIT… MARIE STEN… F <NA> MERCE… 2025 PHYSICIA… 1.04e9 7214… I202…
9 BRIT… MARIE STEN… F <NA> MERCE… 2025 PHYSICIA… 1.04e9 7214… I202…
10 BRIT… MARIE STEN… F <NA> MERCE… 2025 PHYSICIA… 1.04e9 7214… I202…
# ℹ 134 more rows
# ℹ 7 more variables: org_name <chr>, org_pac <chr>, members <int>,
# address <chr>, city <chr>, state <chr>, zip <chr>opt_out(city = "Atlanta", state = "GA")
✔ opt_out returned 352 results.
✔ order_refer returned 148 results.
✔ order_refer returned 59 results.
# A tibble: 352 × 12
npi first last specialty start_date end_date updated address city
* <int> <chr> <chr> <chr> <date> <date> <date> <chr> <chr>
1 1.88e9 Ana Adel… Clinical… 2012-07-01 2026-07-01 2024-08-15 675 SE… ATLA…
2 1.68e9 Sher… Born… Clinical… 2012-04-01 2028-04-01 2026-04-16 990 HA… ATLA…
3 1.70e9 Nich… Hume Clinical… 2018-07-01 2026-07-01 2024-08-15 693 MO… ATLA…
4 1.31e9 Keri… Anas… Nurse Pr… 2012-07-01 2026-07-01 2024-08-15 5780 P… ATLA…
5 1.60e9 Carol Kran… Psychiat… 2012-01-01 2028-01-01 2026-01-15 3133 M… ATLA…
6 1.12e9 Lawr… Gius… Psychiat… 2012-07-01 2026-07-01 2024-08-15 1945 C… ATLA…
7 1.39e9 Ceana Nezh… Obstetri… 2012-10-01 2026-10-01 2024-11-15 5555 P… ATLA…
8 1.07e9 Frank Mata… Integrat… 2018-04-11 2026-04-11 2024-05-15 2296 H… ATLA…
9 1.07e9 Vikt… Bouq… General … 2012-10-01 2026-10-01 2024-11-15 4646 N… ATLA…
10 1.79e9 Will… Oven Clinical… 2017-01-23 2027-01-23 2025-02-15 2801 B… ATLA…
# ℹ 342 more rows
# ℹ 3 more variables: state <chr>, zip <chr>, order_refer <chr>order_refer(first = "Jennifer", last = "Smith")
✔ order_refer returned 136 results.
# A tibble: 136 × 8
first last npi ptb dme hha pmd hospice
<chr> <chr> <int> <int> <int> <int> <int> <int>
1 JENNIFER SMITH 1346518990 1 1 1 0 1
2 JENNIFER SMITH 1366164576 1 1 1 1 0
3 JENNIFER SMITH 1497230395 1 1 1 1 0
4 JENNIFER SMITH 1588617773 1 1 1 1 0
5 JENNIFER SMITH 1073921029 1 1 1 1 0
6 JENNIFER SMITH 1134917859 1 1 1 1 0
7 JENNIFER SMITH 1417514035 1 1 1 1 0
8 JENNIFER SMITH 1972574770 1 1 1 1 1
9 JENNIFER SMITH 1316939655 1 1 1 1 0
10 JENNIFER SMITH 1265417687 0 1 0 1 0
# ℹ 126 more rowsproviders(state = "GA", org_name = contains("West"))
✔ providers returned 144 results.
# A tibble: 144 × 11
org_name first middle last state prov_type prov_desc npi multi pac
<chr> <chr> <chr> <chr> <chr> <chr> <chr> <int> <int> <chr>
1 WESTSIDE END… <NA> <NA> <NA> GA 12-49 PART B S… 1.49e9 0 0143…
2 WEST GEORGIA… <NA> <NA> <NA> GA 12-70 PART B S… 1.88e9 0 0244…
3 WEST PACES S… <NA> <NA> <NA> GA 12-49 PART B S… 1.99e9 0 0345…
4 NORTHWEST GE… <NA> <NA> <NA> GA 12-70 PART B S… 1.57e9 0 0345…
5 CROSSROADS T… <NA> <NA> <NA> GA 12-D5 PART B S… 1.36e9 0 0345…
6 WEST GEORGIA… <NA> <NA> <NA> GA 12-70 PART B S… 1.84e9 0 0446…
7 PREFERRED VA… <NA> <NA> <NA> GA 12-70 PART B S… 1.79e9 0 0446…
8 WEST COBB SP… <NA> <NA> <NA> GA 12-A5 PART B S… 1.18e9 0 0446…
9 NORTHWEST IO… <NA> <NA> <NA> GA 12-70 PART B S… 1.22e9 0 0749…
10 NORTHWEST EN… <NA> <NA> <NA> GA 12-49 PART B S… 1.99e9 0 0749…
# ℹ 134 more rows
# ℹ 1 more variable: enid <chr>pending(first = starts("E"), last = ends("A"))
✔ pending returned 34 results.
• Physician : 12
• Non-Physician : 22
ℹ Retrieving 2 pages...
# A tibble: 34 × 4
prov_type first last npi
<chr> <chr> <chr> <int>
1 Physician EDUARDO QUINONEZ ZANABRIA 1871233668
2 Physician EILEEN SANTA 1952440083
3 Physician ELEANOR FONTANA 1851233233
4 Physician ELIAS SALAMA 1508660655
5 Physician ELISSA OTA 1487414637
6 Physician ELIZA LAMA 1437099082
7 Physician ELIZABETH PERAZZA 1942230891
8 Physician ELLEN HUHULEA 1659219442
9 Physician ELYSSA MOLINA 1508624891
10 Physician EMMA COSTANZA 1538892286
# ℹ 24 more rowshospitals(city = "Valdosta", state = "GA")
✔ hospitals returned 3 results.
# A tibble: 3 × 17
org_name org_dba enid npi multi ccn pac inc_date org_type status
* <chr> <chr> <chr> <int> <int> <chr> <chr> <date> <chr> <chr>
1 GREENLEAF C… GREENL… O201… 1.54e9 0 1140… 7416… 2012-07-13 LLC P
2 SOUTH GEORG… SGMC H… O202… 1.14e9 0 1101… 1052… 2021-11-09 CORPORA… N
3 SOUTH GEORG… <NA> O202… 1.60e9 0 11T1… 1052… 2021-11-09 CORPORA… N
# ℹ 7 more variables: address <chr>, city <chr>, state <chr>, zip <chr>,
# loc_type <chr>, reh_date <date>, sub_group <chr>clia(fac_name = starts("SGMC"), state = "GA")
✔ clia returned 32 results.
# A tibble: 32 × 22
fac_name fac_ccn clia_ccn chows labs sites address city state zip term
* <chr> <chr> <chr> <int> <int> <int> <chr> <chr> <chr> <chr> <chr>
1 SGMC HEAL… 11D002… 110122 0 1 0 2501 N… VALD… GA 31602 Acti…
2 SGMC- SMI… 11D002… 110037 0 1 0 4280 N… VALD… GA 31602 Acti…
3 SGMC WOME… 11D026… <NA> 0 0 0 3312 N… VALD… GA 31605 Acti…
4 SGMC VALD… 11D026… 2585892… 0 2 0 3207 C… VALD… GA 31605 Acti…
5 SGMC- LAN… 11D026… 110097 0 3 2 116 WE… LAKE… GA 31635 Acti…
6 SGMC-BERR… 11D026… 11-0112 0 8 0 1221 E… NASH… GA 31639 Acti…
7 SGMC PRIM… 11D069… 2568644… 0 0 0 410 CO… VALD… GA 31602 Acti…
8 SGMC HEAL… 11D091… <NA> 0 0 0 138 WE… LAKE… GA 31635 Acti…
9 SGMC PRIM… 11D093… <NA> 0 1 0 4370 K… VALD… GA 31602 Acti…
10 SGMC FAMI… 11D094… <NA> 0 0 0 1225 E… NASH… GA 31639 Acti…
# ℹ 22 more rows
# ℹ 11 more variables: cert_type <chr>, fac_type <chr>, owner <chr>,
# action <chr>, cert_date <date>, eff_date <date>, term_date <date>,
# elig_ind <chr>, poc_ind <chr>, multi_site <chr>, acr_org <chr>transparency(action = "cap", state = "GA")
✔ transparency returned 47 results.
# A tibble: 47 × 7
case fac_name address city state action action_date
<int> <chr> <chr> <chr> <chr> <chr> <date>
1 1326 Anchor Hospital "5454 … Atla… GA CAP R… 2023-09-15
2 6510 Appling Healthcare System "163 E… Baxl… GA CAP R… 2025-12-10
3 265 Archbold Memorial "915 G… Thom… GA CAP R… 2023-04-14
4 6616 Candler County Hospital "400 C… Mett… GA CAP R… 2025-12-19
5 256 Coffee Regional Medical Center "1101 … Doug… GA CAP R… 2023-06-15
6 2502 Colquitt Regional Medical Center " 3131… Moul… GA CAP R… 2024-11-25
7 2759 Columbus Specialty Hospital "616 1… Colu… GA CAP R… 2024-10-02
8 2759 Columbus Specialty Hospital "616 1… Colu… GA CAP R… 2025-01-08
9 6997 Dorminy Medical Center "200 P… Fitz… GA CAP R… 2026-02-10
10 1318 Emory Saint Joseph's Hospital "550 P… Atla… GA CAP R… 2023-10-17
# ℹ 37 more rowsPlease note that the provider project is released with a
Contributor Code of
Conduct.
By contributing to this project, you agree to abide by its terms.
This project is primarily maintained by Andrew Bruce. Other authors may occasionally assist with some of these duties.