Utilities for Interacting with the 'CTX' APIs
Overview
Access chemical, hazard, bioactivity, and exposure data from the Computational Toxicology and Exposure ('CTX') APIs https://www.epa.gov/comptox-tools/computational-toxicology-and-exposure-apis. 'ctxR' was developed to streamline the process of accessing the information available through the 'CTX' APIs without requiring prior knowledge of how to use APIs. Most data is also available on the CompTox Chemical Dashboard ('CCD') https://comptox.epa.gov/dashboard/ and other resources found at the EPA Computational Toxicology and Exposure Online Resources https://www.epa.gov/comptox-tools.
Major improvements and fixes
- Update api host from cloud.gov to local server throughout package (#70)
New Features
- Added functions for the Exposure domain CCD endpoints
get_product_use_category(),
get_product_use_categories_batch(), get_production_volume(),
get_production_volume_batch(), get_biomonitoring_data(), get_biomonitoring_data_batch(),
get_general_use_keywords(), get_general_use_keywords_batch(), get_reported_functional_use(),
get_reported_functional_use_batch(), get_chemical_weight_fraction(), and
get_chemical_weight_fraction_batch() (#71).
- Added functions for Exposure domain MMDB endpoints
get_medium_categories(),
get_single_sample_records_by_dtxsid(), get_single_sample_records_by_dtxsid_batch(),
get_single_sample_records_by_medium(), get_single_sample_records_by_medium_batch(),
Show all changes in 1.1.3Hide the rest of the changes in 1.1.3
get_aggregate_records_by_dtxsid(), get_aggregate_records_by_dtxsid_batch(),
get_aggregate_records_by_medium(), get_aggregate_records_by_medium_batch() (#71).
- Added examples to
ctxR_04_Exposure.Rmdvignette for new CCD and MMDB endpoint
functions (#71).
From NEWS.md in the release
Install
Health
- OK13 OK2026-08-05
- NOTE12 OK, 1 NOTE2026-08-01
- OK13 OK2026-06-09
- ERROR12 OK, 1 ERROR2026-06-08
- OK14 OK2026-03-10
Documentation
- Help pages
- 128 (7 internal)
- Examples that run
- 100%121 run in a plain check (121 of them under a condition)
- Exported functions with examples
- 100%
- Documented parameters
- 100%
- Return-value docs
- 100%
- Help pages citing references
- 0%
Downloads
Repository
- PRs merged (all time)
- 98%
- Median days to close, 50 most recently updated closed issues
- 12
- Median days to close, 50 most recently updated closed PRs
- 4
Stars over time
Forks over time
Releases over time
Issues over time
PRs over time
Commits over time
10 development-tooling and community-health practices detected across 5 families in the upstream repository
Checks run against github.com/usepa/ctxr on 2026-10-18.
GitHub Pages site last deployed 2026-10-09 · The repository has a site deploy workflow
pkgdown site last built 2024-08-05, before release 1.1.3 (2025-10-08)
Show all practicesHide 1 practice
Dependencies
Installing ctxR adds 31 packages (22 with compiled code, 28 MB of source tarballs). Heaviest: stringi 11 MB, data.table 5.7 MB, Rcpp 1.8 MB.
Code & Tests
Datasets
People & History
Previously maintained by Jason Brown (1.1.1) and Paul Kruse (1.0.0 to 1.1.0).
Pick two releases to compare their code metrics.
- RR 4.6.0 released · 2026-04-24
- 1.1.3Latest2025-10-08 · current release · diff ↗ ·
added 26 exports
get_aggregate_records_by_dtxsid, get_aggregate_records_by_dtxsid_batch, get_aggregate_records_by_medium, get_aggregate_records_by_medium_batch, get_biomonitoring_data, get_biomonitoring_data_batch, get_chem_props_exp, get_chem_props_exp_batch, get_chem_props_pred, get_chem_props_pred_batch, get_chem_props_summary, get_chemical_weight_fraction, get_chemical_weight_fraction_batch, get_general_use_keywords, get_general_use_keywords_batch, get_medium_categories, get_product_use_categories_batch, get_product_use_category, get_production_volume, get_production_volume_batch, get_reported_functional_use, get_reported_functional_use_batch, get_single_sample_records_by_dtxsid, get_single_sample_records_by_dtxsid_batch, get_single_sample_records_by_medium, get_single_sample_records_by_medium_batch - RR 4.5.0 released · 2025-04-11
- 1.1.22025-04-07 · diff ↗
- 1.1.12025-04-02 · diff ↗
- 1.1.02025-01-08 · diff ↗ ·
added 15 exports
check_existence_by_dtxsid, check_existence_by_dtxsid_batch, get_all_list_types, get_chemicals_in_list_contain, get_chemicals_in_list_contain_batch, get_chemicals_in_list_exact, get_chemicals_in_list_exact_batch, get_chemicals_in_list_start, get_chemicals_in_list_start_batch, get_demographic_exposure_prediction, get_demographic_exposure_prediction_batch, get_general_exposure_prediction, get_general_exposure_prediction_batch, get_httk_data, get_httk_data_batch - 1.0.02024-07-04
- RR 4.4.0 released · 2024-04-24
Package metadata
- First published
- 2024-07-04
- Total releases
- 5 / 2 yrs
- License
- GPL (>= 3) OSI
- Minimum R
- ≥ 3.5
- Bundled data
- 0.5 KB / 4 files
- Download size
- 4.5 MB
Cite
Cite this package
Run in R for the authors' entry:
citation("ctxR")The package provides a citation file, so citation() returns the authors' own entry.
It points to 10.1016/j.namjnl.2025.100031.
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.