License: MIT Travis build status AppVeyor build status Coverage status CRAN_Status_Badge GitHub tag DOI


The ukpolice package downloads data from the UK Police public data API, the full docs of which are available at Data is available on police forces, crimes, policing areas and stop-and-search.

ukpolice is on CRAN, which you can download using:


You can install the development version of ukpolice from github with:

# install.packages("devtools")

Data is available on police forces, crimes, policing areas and stop-and-search. All functions begin with ukc_.

The example below queries stop and searches by the Thames Valley Police in December 2018, and plots them by police-reported ethnic group.


tv_ss <- ukc_stop_search_force("thames-valley", date = "2018-12")

tv_ss2 <- tv_ss %>% 
  filter(! & outcome != "" ) %>%
  group_by(officer_defined_ethnicity, outcome) %>%
  summarise(n = n()) %>%
  mutate(perc = n/sum(n))

p1 <- ggplot(tv_ss2, aes(x = outcome, y = perc,
                             group = outcome, fill = outcome)) + 
  geom_col(position = "dodge") + 
  scale_y_continuous(labels = scales::percent,
                     breaks = seq(0.25, 0.8, by = 0.25)) + 
  scale_x_discrete(labels = scales::wrap_format(15)) + 
  theme(legend.position = "none", axis.text.x = element_text(size = 7)) + 
  labs(x = "Outcome", 
       y = "Percentage of stop and searches resulting in outcome",
       title = "Stop and Search Outcomes by Police-Reported Ethnicity",
       subtitle = "Thames Valley Police Department, December 2018",
       caption = "(c) Evan Odell | 2019 | CC-BY-SA") + 


For more details, see the package vignette vignette and function documentation.


Please note that the ‘ukpolice’ project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.

The UK Police API is operated by the UK Government’s Home Office. The ukpolice package is not affiliated with the Home Office. All data accessed through ukpolice is licenced with Open Government Licence v3.0.

Get citation information for ukpolice in R with citation(package = 'ukpolice'), or use the citation information below:

Odell E, Tierney N (2019). ukpolice: Download Data on UK Police and Crime. doi: 10.5281/zenodo.2619537, R package version, URL:

A BibTeX entry for LaTeX users is:

    title = {{ukpolice}: Download Data on UK Police and Crime},
    author = {Evan Odell and Nicholas Tierney},
    year = {2019},
    note = {R package version},
    doi = {10.5281/zenodo.2619537},
    url = {},