Interaction Between R and REDCap
Overview
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.
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()andredcap_variable()accept a delimiter, to accommodate server instances in locales that use something other than a comma. The delimiter is passed toreadr::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 newdagandrolecolumns (#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 forrecord_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_idvalues before passing toredcap_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
- OK13 OK2026-09-08
- ERROR12 OK, 1 ERROR2026-09-07
- OK13 OK2026-08-26
- NOTE10 OK, 3 NOTE2026-07-16
- OK14 OK2026-03-10
Documentation
- 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
Repository
- 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
Forks over time
Releases over time
Issues over time
PRs over time
Commits over time
Commit identities over time
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.
The R CMD check workflow runs on Linux, macOS and Windows
GitHub Pages site last deployed 2026-09-21 · The repository has a site deploy workflow
pkgdown site last built 2026-09-21
Show all practicesHide 4 practices
Dependencies
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.
Code & Tests
People & History
Show 8 more contributorsHide 8 contributors
Pick two releases to compare their code metrics.
- 1.7.0Latest2026-08-20 · current release · diff ↗ ·
added 3 exports
kernel_api, redcap_instrument_repeating, to_api_array - RR 4.6.0 released · 2026-04-24
- 1.6.02025-10-08 · diff ↗
- 1.5.02025-07-29 · diff ↗
- RR 4.5.0 released · 2025-04-11
- 1.4.0
- 1.3.02024-10-23 · diff ↗
- 1.2.02024-09-09 · diff ↗ ·
removed 1 export
validate_field_names_collapsedadded 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 - RR 4.4.0 released · 2024-04-24
- RR 4.3.0 released · 2023-04-21
- 1.1.02022-08-10 · diff ↗ ·
added 5 exports
redcap_arm_export, redcap_dag_read, redcap_delete, redcap_event_instruments, redcap_instruments - RR 4.2.0 released · 2022-04-22
- 1.0.0
- RR 4.1.0 released · 2021-05-18
- RR 4.0.0 released · 2020-04-24
- 0.11.02020-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.22019-09-23 · diff ↗ ·
removed 1 export
retrieve_token_mssqladded 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 - RR 3.6.0 released · 2019-04-26
- RR 3.5.0 released · 2018-04-23
- 0.9.82017-05-18 · diff ↗ ·
removed 1 export
validate_no_uppercaseadded 4 exports
redcap_variables, redcap_version, sanitize_token, validate_field_names - RR 3.4.0 released · 2017-04-21
- 0.9.7
- RR 3.3.0 released · 2016-05-03
- 0.9.32015-08-26 · diff ↗
- 0.9.02015-08-15 · diff ↗
- RR 3.2.0 released · 2015-04-16
- 0.7-1
- 0.4-282014-09-20
- RR 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
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("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.
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.