Download HMRC tobacco duty receipts

Downloads and tidies the HMRC Tobacco Bulletin, which reports monthly tobacco products duty receipts by product type. Data runs from January 1991 to the most recent published month.

Usage

hmrc_tobacco_duties(product = NULL, start = NULL, end = NULL, cache = TRUE)

Source

https://www.gov.uk/government/statistics/tobacco-bulletin

Arguments

product

Character vector or NULL (default = all products). Valid values: "cigarettes", "cigars", "hand_rolling", "other", "total".

start

Character "YYYY-MM" or a Date object.

end

Character "YYYY-MM" or a Date object.

cache

Logical. Use cached file if available (default TRUE).

Value

An hmrc_tbl with columns date, product, description, receipts_gbp_m, and provisional (logical, TRUE for months HMRC flags as provisional).

See also

Other data fetchers: hmrc_capital_gains(), hmrc_corporation_tax(), hmrc_creative_industries(), hmrc_fuel_duties(), hmrc_income_tax_stats(), hmrc_inheritance_tax(), hmrc_patent_box(), hmrc_property_transactions(), hmrc_rd_credits(), hmrc_stamp_duty(), hmrc_tax_gap(), hmrc_tax_receipts(), hmrc_vat()

Examples

# \donttest{
op <- options(hmrc.cache_dir = file.path(tempdir(), "hmrc"))
try({
  tob <- hmrc_tobacco_duties(product = "cigarettes", start = "2024-01")
  head(tob)
})
#> ℹ Resolving download URL from GOV.UK Content API
#> ✔ Resolving download URL from GOV.UK Content API [115ms]
#> 
#> ℹ Downloading data file
#> ✔ Downloading data file [180ms]
#> 
#> ℹ Parsing data
#> ✔ Parsing data [72ms]
#> 
#> # Tobacco Bulletin
#> # Source: https://www.gov.uk/government/statistics/tobacco-bulletin
#> # Fetched 2026-09-13 19:24:27 UTC | Vintage: latest | Cells: cash | Freq: monthly | 6 rows x 5 cols
#> 
#>         date    product description receipts_gbp_m provisional
#> 1 2024-01-01 cigarettes  Cigarettes       694.3751       FALSE
#> 2 2024-02-01 cigarettes  Cigarettes       478.3896       FALSE
#> 3 2024-03-01 cigarettes  Cigarettes       466.0025       FALSE
#> 4 2024-04-01 cigarettes  Cigarettes       617.1496       FALSE
#> 5 2024-05-01 cigarettes  Cigarettes       352.3243       FALSE
#> 6 2024-06-01 cigarettes  Cigarettes       447.4154       FALSE
options(op)
# }