Skip to content

Access the U.S. National Provider Identifier Registry API

0packages depend
4.1Kdownloads / year
99.6%test coverage
13/13flavors OK

Overview

About

Access the United States National Provider Identifier Registry API https://npiregistry.cms.hhs.gov/api/. Obtain and transform administrative data linked to a specific individual or organizational healthcare provider, or perform advanced searches based on provider name, location, type of service, credentials, and other attributes exposed by the API.

Changes in 0.3.1

BUG FIXES

  • npi_search() retains previously retrieved records when a later page is empty.
  • npi_flatten() preserves all input keys when selected nested data is empty, regardless of column order.
  • npi_summarize() formats complete addresses when an optional second address line is absent or missing.
  • Result validation now checks each column's expected type and requires POSIXct timestamps.

MINOR IMPROVEMENTS

  • Tests no longer require live API connectivity or pagination delays.
  • Summary column selection no longer triggers tidyselect deprecation warnings.

DOCUMENTATION FIXES

  • Vignettes build without API access and clearly distinguish live search examples from executable examples using bundled data.
  • Documented flattening behavior for empty nested data and the existing result type contract.

From NEWS.md in the release

Install

Health

CRAN checks
13OK
Slowest check: 1.6 min · r-oldrel-windows-x86_64
Status changes
  • OK13 OK2026-08-17
  • ERROR12 OK, 1 ERROR2026-08-16
  • OK13 OK2026-08-05
  • NOTE12 OK, 1 NOTE2026-08-01
  • OK13 OK2026-07-19
Show 2 earlier changesHide 2 earlier changes
  • ERROR10 OK, 1 NOTE, 2 ERROR2026-06-27
  • NOTE12 OK, 2 NOTE2026-03-10
Advisories

none known

Documentation

In release 0.3.1
READMEYes · 1,847 wordsVignettesYes · 2 · dynamicNEWSYes · 100% structured · mentions 0.3.1Citation fileYes · software entry onlyWebsiteYes · pkgdown
Help pages
11 (4 internal)includes a package overview page
Examples that run
83%5 run in a plain check · 1 never run
Exported functions with examples
80%
Documented parameters
100%
Return-value docs
100%
Help pages citing references
9%

Downloads

4.1K
CRAN downloads in the past year
Rank #8,168 · ~11/day · ~345/mo
Daily download trend is not available in this view yet.
44830 days
1.1K90 days
4.1K1 year
Compare downloads with other packages →
Also on97 r2u7 autocran45 c2d4u

Repository

38Stars
10Forks
4Open issues
0Open PRs
4Releases
200Commits
3Commit identities
api-wrapperrnpi-numberhealthcarehealth-datar-packagerstats
200 commits · Last activity 2026-09-24 · 0% stars, 30d
Responsiveness
How these are sampled
PRs merged (all time)
81%
Median days to close, 50 most recently updated closed issues
219
Median days to close, 50 most recently updated closed PRs
0

Stars over time

2025-03-01 · 362026-07-07 · 38
PracticesBeta

18 development-tooling and community-health practices detected across 9 families in the upstream repository

Checks run against github.com/ropensci/npi on 2026-10-18.

Continuous integration (2)
GitHub ActionsR CMD check workflow

The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel

Governance and community (4)
Code of conduct (inherited from ropensci)Contributing guideIssue templatesPR template
Docs source (4)
README.Rmdpkgdown

GitHub Pages site last deployed 2026-09-24 · The repository has a site deploy workflow

Coverage (1)
Coverage reporting (Codecov)
Show all practicesHide 5 practices
Reproducibility and dev environment (1)
data-raw/
CRAN release process (2)
cran-comments.mdCRAN-SUBMISSION
Research and citation (2)
CITATION.cffcodemeta.json
Automation and maintenance (1)
Dependabot
Lint, format, editor (1)
RStudio project
How this is detected·Detection ruleset v3 (2026-09-26)
AI coding toolsBeta

This repository shows signs of AI coding tools.

  • Codexfirst seen 2025-11-03
    Pull request it wrote: opened by a project member
Shared conventions any agent may read, so they name no particular tool.
Seen in the repository: AGENTS.md
How this is detected·Detection ruleset v4 (updated 2026-09-27)

Dependencies

Declared dependencies
19 external dependencies (excludes base and recommended)

Installing npi adds 30 packages (20 with compiled code, 21 MB of source tarballs). Heaviest: stringi 11 MB, openssl 1.1 MB, jsonlite 1.0 MB.

Depends (1)
R >= 3.1
LinkingTo (0)
none
Enhances (0)
none
Reverse dependencies
0direct
0indirect

Nothing depends on this yet.

Datasets

People & History

People (4)
Maintainer since 0.2.0 (2022), Author, Copyright holder
Contributor
Listed in earlier versions (1)
Emily C.
no longer listed · 0.2.0 to 0.3.1
Releases (3)

Pick two releases to compare their code metrics.

  • 0.3.1Latest
    record
    2026-09-06 · current release · diff ↗
  • 0.3.0
    record
    2026-07-12 · diff ↗
  • R
    R 4.6.0 released · 2026-04-24
  • R
    R 4.5.0 released · 2025-04-11
  • R
    R 4.4.0 released · 2024-04-24
  • R
    R 4.3.0 released · 2023-04-21
  • 0.2.0
    record
    2022-11-14
  • R
    R 4.2.0 released · 2022-04-22

Package metadata

First published
2022-11-14
Total releases
3 / 4 yrs
License
MIT + file LICENSE OSI
Minimum R
≥ 3.1
Bundled data
3.0 KB / 1 file
Download size
109 KB

Cite

Cite this package

Run in R for the authors' entry:

citation("npi")

The package provides a citation file, so citation() returns the authors' own entry.

It points to 10.5281/zenodo.6326729.

The repository also keeps a CITATION.cff.

Cite the R Observatory

For a number measured here: a download total, a coverage figure, an archival date.

APA

Balamuta, J. J. (2026). R Observatory: Metrics for npi version 0.3.1 [Data set]. HJJB, LLC. Data release v2026-10-22. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-22, which the citation names so these numbers can be found later. More on citing and the projects behind them.

Report a problem with this page →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy