CRAN status R-CMD-check Codecov test coverage Lifecycle: experimental

restatis is a wrapper around the RESTful API that provides access to the GENESIS databases of the Federal Statistical Office of Germany (Destatis).


You can install the released version of restatis from CRAN:


Or install the development version of restatis from GitHub with:

# install.packages("devtools")



To access the Destatis GENESIS API, you need to have an account at and store your username and password for use in R with gen_auth_save() (see ?gen_auth_save for more details).

Main features

restatis provides functions (prefixed with gen_) for finding, exploring, and retrieving data from the GENESIS API. See the “Basic restatis workflow” vignette for an overview of the main features of the package.


restatis uses memoisation to cache query results. This means that if you call a function multiple times with the same input, the values returned the first time are stored and reused from the second time.

Cached objects are stored in the memory and do not persist across R sessions.


This package is in no way affiliated with the German Federal Statistical Office (Destatis). It is a simple wrapper providing R functions to access Destatis’ API. The package authors are in no way responsible for the data that can be retrieved using its functions. The license of this package solely applies to its source code.