nhstt

This package is under active development. Breaking changes are likely.

nhstt provides access to publicly available NHS Talking Therapies reports in a tidy data format.

Installation

Install the development version from GitHub:

# install.packages("pak")
pak::pak("bennettoxford/nhstt")

Usage

library(nhstt)

# Load annual key measures dataset for financial year 2024-25
km_annual <- get_key_measures_annual(periods = "2024-25")

# Load all monthly activity performance datasets
# Note, this will take a few minutes
ap_monthly <- get_activity_performance_monthly()

Available NHS Talking Therapies data

Annual data

Function	First period	Last period	Count periods	Version
get_key_measures_annual()	2017-18	2024-25	8	0.2.0
get_proms_annual()	2019-20	2024-25	6	0.1.0
get_therapy_position_annual()	2019-20	2024-25	6	0.1.0

Monthly data

Function	First period	Last period	Count periods	Version
get_activity_performance_monthly()	2023-05	2025-09	29	0.2.0

Metadata

Function	First period	Last period	Count periods	Version
get_metadata_measures_annual()	2024-25	2024-25	1	0.1.0
get_metadata_variables_annual()	2024-25	2024-25	1	0.1.0
get_metadata_monthly()	2025-07	2025-07	1	0.1.0
get_metadata_providers()	current	current	1	0.1.0

Time to download and tidy the data

Approximate download and processing times per period. Your times might be a bit faster or slower depending on your internet speed and computer setup.

Function	Download per period	Tidy per period	Total (all periods)
get_key_measures_annual()	1.9 sec	32.5 sec	4.6 min
get_proms_annual()	0.88 sec	1.1 min	6.7 min
get_therapy_position_annual()	0.66 sec	0.86 sec	9.1 sec
get_activity_performance_monthly()	2.6 sec	1.5 sec	2 min

For developers

See DEVELOPERS.md.

Licence

R package

The nhstt package is licensed under the MIT License.

NHS Talking Therapies data

All NHS Talking Therapies data is Copyright NHS England and licensed under the Open Government Licence v3.0. Contains public sector information licensed under the Open Government Licence v3.0.