Skip to content

REDCapR

1.7.0Package record

Interaction Between R and REDCap

7packages dependsuggested by 1
23.3Kdownloads / year
95.9%test coverage
13/13flavors OK

Overview

About

Encapsulates functions to streamline calls from R to the REDCap API. REDCap (Research Electronic Data CAPture) is a web application for building and managing online surveys and databases developed at Vanderbilt University. The Application Programming Interface (API) offers an avenue to access and modify data programmatically, improving the capacity for literate and reproducible programming.

Changes in 1.7.0

New Features

  • New redcap_instrument_repeating() function exports repeating instrument-event mappings for a project (#585 & #589, @ezraporter).
  • redcap_event_instruments(), redcap_event_read(), redcap_instruments(), redcap_project_info_read(), redcap_read(), redcap_read_oneshot()and redcap_variable() accept a delimiter, to accommodate server instances in locales that use something other than a comma. The delimiter is passed to readr::read_delim() (#570, @mrkskk).

Minor Enhancements

  • New columns returned from the server to redcap_project_info_read() no longer throw a warning (#587).
  • redcap_file_repo_list_oneshot() function tests for the new dag and role columns (#593).
  • redcap_write() now accommodates single-column data.frames. Previously only single-column tibbles were accommodated (@brandonerose, #591 & #592).
  • Update urls for REDCap Community (#596).
  • Simplified token files for other people to test with (#594).
  • New test project that includes both longitudinal events, and repeated measures (#606, needed to test #589).
  • Update deprecated parameters for `base::structure (#605).
  • validate_for_write() now accommodates projects with a custom name for record_id (#601, #602, @vanbibn).
Show all changes in 1.7.0Hide the rest of the changes in 1.7.0
  • Follows new rules from the goodpractice package released in the past year (#610).
  • New example demonstrates removing non-existing record_id values before passing to redcap_delete() (#567).

Bug fixes

  • When writing to the server, a numeric value like "10000" will not be converted to scientific notation (#599, #600, @Olawemi5).

From NEWS.md in the release

Install

Health

CRAN checks
13OK
Slowest check: 2.7 min · r-oldrel-windows-x86_64
Status changes
  • OK13 OK2026-09-08
  • ERROR12 OK, 1 ERROR2026-09-07
  • OK13 OK2026-08-26
  • NOTE10 OK, 3 NOTE2026-07-16
  • OK14 OK2026-03-10
Advisories

none known

Documentation

In release 1.7.0
READMEYes · 675 wordsVignettesYes · 7 · dynamicNEWSYes · 100% structured · mentions 1.7.0Citation fileNoWebsiteYes · pkgdown
Help pages
41 (1 internal)includes a package overview page
Examples that run
30%12 run in a plain check · 27 never run · 1 hold no code
Exported functions with examples
97%
Documented parameters
100%
Return-value docs
97%
Help pages citing references
66%

Downloads

23.3K
CRAN downloads in the past year
Rank #2,596 · ~64/day · ~1.9K/mo
Daily download trend is not available in this view yet.
1.9K30 days
5.9K90 days
23.3K1 year
Compare downloads with other packages →
Also on179 r2u7 autocran2.3K conda_forge107 c2d4u

Repository

137Stars
48Forks
24Open issues
0Open PRs
16Releases
2,495Commits
30Commit identities
redcapredcap-apirr-package
2,495 commits · Last activity 2026-09-21 · 0% stars, 30d · Default branch at 1.7.0.9000, ahead of CRAN 1.7.0 (checked 2026-10-18)
Responsiveness
How these are sampled
PRs merged (all time)
98%
Median days to close, 50 most recently updated closed issues
10
Median days to close, 50 most recently updated closed PRs
0

Stars over time

2025-10-07 · 1272026-08-20 · 137
PracticesBeta

14 development-tooling and community-health practices detected across 8 families in the upstream repository

Checks run against github.com/ouhscbbmc/redcapr on 2026-10-18.

Continuous integration (2)
GitHub ActionsR CMD check workflow

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

Governance and community (2)
Code of conductIssue templates
Docs source (3)
pkgdown

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

pkgdown site last built 2026-09-21

Coverage (1)
Coverage reporting (Codecov)
Show all practicesHide 4 practices
CRAN release process (1)
cran-comments.md
Automation and maintenance (1)
Dependabot
Lint, format, editor (3)
lintrVS CodeRStudio project
Git structural (1)
.gitattributes
How this is detected·Detection ruleset v3 (2026-09-26)

Dependencies

Declared dependencies
21 external dependencies (excludes base and recommended)

Installing REDCapR adds 39 packages (25 with compiled code, 23 MB of source tarballs). Heaviest: stringi 11 MB, openssl 1.1 MB, jsonlite 1.0 MB.

Depends (1)
R >= 3.5.0
LinkingTo (0)
none
Enhances (0)
none
Reverse dependencies
7direct
0indirect
Imports 7
Suggested by 1
Depends, Imports or LinkingTo, most downloaded first
Suggests, most downloaded first

People & History

People (17)
Author, Maintainer since 0.4-28 (2014)
Contributor
Contributor
Contributor · added in 1.2.0
Contributor · added in 1.1.0
Contributor · added in 0.11.0
Contributor · added in 1.2.0
Contributor · added in 1.1.0
Contributor · added in 1.1.0
Show 8 more contributorsHide 8 contributors
Contributor · added in 0.7-1
Contributor
Contributor · added in 0.7-1
Contributor · added in 1.2.0
Contributor · added in 1.2.0
Contributor · added in 0.11.0
Contributor
Contributor · added in 0.9.7
Releases (16)

Pick two releases to compare their code metrics.

  • 1.7.0Latest
    record
    2026-08-20 · current release · diff ↗ ·
    added 3 exports
    kernel_api, redcap_instrument_repeating, to_api_array
  • R
    R 4.6.0 released · 2026-04-24
  • 1.6.0
    record
    2025-10-08 · diff ↗
  • 1.5.0
    record
    2025-07-29 · diff ↗
  • R
    R 4.5.0 released · 2025-04-11
  • 1.4.0
    record
    2025-01-11 · diff ↗ ·
    added 1 export
    redcap_file_repo_list_oneshot
  • 1.3.0
    record
    2024-10-23 · diff ↗
  • 1.2.0
    record
    2024-09-09 · diff ↗ ·
    removed 1 export
    validate_field_names_collapsed
    added 11 exports
    redcap_event_read, redcap_file_download_oneshot, redcap_file_upload_oneshot, redcap_instrument_download, redcap_log_read, redcap_metadata_coltypes, redcap_project_info_read, validate_data_frame_inherits, validate_record_id_name, validate_repeat_instance, validate_uniqueness
  • R
    R 4.4.0 released · 2024-04-24
  • R
    R 4.3.0 released · 2023-04-21
  • 1.1.0
    record
    2022-08-10 · diff ↗ ·
    added 5 exports
    redcap_arm_export, redcap_dag_read, redcap_delete, redcap_event_instruments, redcap_instruments
  • R
    R 4.2.0 released · 2022-04-22
  • 1.0.0
    record
    2021-07-22 · diff ↗ ·
    added 2 exports
    create_credential_local, redcap_report
  • R
    R 4.1.0 released · 2021-05-18
  • R
    R 4.0.0 released · 2020-04-24
  • 0.11.0
    record
    2020-04-22 · diff ↗ ·
    added 4 exports
    redcap_download_instrument, redcap_metadata_write, redcap_survey_link_export_oneshot, validate_field_names_collapsed
Show 13 earlier eventsHide 13 earlier events
  • 0.10.2
    record
    2019-09-23 · diff ↗ ·
    removed 1 export
    retrieve_token_mssql
    added 7 exports
    constant, constant_to_access, constant_to_export_rights, constant_to_form_completion, constant_to_form_rights, redcap_next_free_record_name, redcap_users_export
  • R
    R 3.6.0 released · 2019-04-26
  • R
    R 3.5.0 released · 2018-04-23
  • 0.9.8
    record
    2017-05-18 · diff ↗ ·
    removed 1 export
    validate_no_uppercase
    added 4 exports
    redcap_variables, redcap_version, sanitize_token, validate_field_names
  • R
    R 3.4.0 released · 2017-04-21
  • 0.9.7
    record
    2016-09-09 · diff ↗ ·
    added 2 exports
    retrieve_credential_local, retrieve_credential_mssql
  • R
    R 3.3.0 released · 2016-05-03
  • 0.9.3
    record
    2015-08-26 · diff ↗
  • 0.9.0
    record
    2015-08-15 · diff ↗
  • R
    R 3.2.0 released · 2015-04-16
  • 0.7-1
    record
    2014-12-18 · diff ↗ ·
    added 3 exports
    checkbox_choices, redcap_metadata_read, regex_named_captures
  • 0.4-28
    record
    2014-09-20
  • R
    R 3.1.0 released · 2014-04-10

Package metadata

First published
2014-09-20
Total releases
16 / 12 yrs
License
MIT + file LICENSE OSI · relicensed from GPL-2 in 1.0.0
Minimum R
≥ 3.5.0
Download size
1.1 MB
Appears in task views

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("REDCapR")
Beasley, W., Aponte, J. J., Bard, D., Botwin, G., Castro, V., Chase, P., Kadauke, S., Linkersdörfer, J., Mang, J., Nutter, B., Parrish, R., Peters, A., Porter, E., Schuelke, M., Torres, F., Wilson, T., & Zhu, H. (2026). REDCapR: Interaction Between R and REDCap (Version 1.7.0) [Computer software]. https://doi.org/10.32614/CRAN.package.REDCapR

This package has no citation file, so citation() returns this entry built from DESCRIPTION.

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 REDCapR version 1.7.0 [Data set]. HJJB, LLC. Data release v2026-10-20. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-20, 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