get_forcedecks_tests_only: Get only ForceDecks test data

In valdr: Access and Analyse 'VALD' Data via Our External 'APIs'

Get only ForceDecks test data

Description

Wrapper around get_forcedecks_tests() if the user only wants test-level data without trials.

Usage

get_forcedecks_tests_only(start_date = NULL, include_attributes = FALSE)

Arguments

start_date	In ISO 8601 UTC format (e.g., "2025-06-25T00:00:00Z") indicating the start of the test retrieval window.
include_attributes	Logical; if TRUE, returns a named list with tests (the test data frame) and attributes (the long-format attributes mapping table). If FALSE (default), returns only the tests data frame.

Value

Either a data frame containing ForceDecks test-level data, or a list with components tests and attributes if include_attributes = TRUE.

Examples

## Not run: 
# Fetch only tests
tests <- get_forcedecks_tests_only()

# Fetch tests plus attributes mapping
res <- get_forcedecks_tests_only(include_attributes = TRUE)
tests <- res$tests
attrs <- res$attributes

## End(Not run)

valdr documentation built on April 22, 2026, 9:08 a.m.