Effectiveness of COVID-19 vaccinations in Finland
This describes the open data of Finnish Institute of Health and Welfare, which describes the effectiveness of COVID-19 vaccines in Finland.
The material is aimed at citizens, the media, the authorities and researchers to provide information on the risks of serious COVID-19 disease in different demographics and vaccination immunisations.
The data will be published via THL’s open data API.
The data can also be viewed directly on the data sheets and pre-assembled graphs. The tables are published as data cubes, which enables the users to select data from the materials.
- Data cube: Effectiveness of coronavirus vaccinations in Finland
- Instructions for the data cube
- Graphs compiled from the data
API address: https://sampo.thl.fi/pivot/prod/api/epirapo/covid19inci.json
Subject area of the data: epirapo
Name of the subject: covid19inci
Description of THL’s open data API
THL's open data license and limitation of liability
Description of the data
The population of the data includes all persons in the Finnish population information system. The data contains information on the incidence of COVID-19 infections and severe disease in different age groups, between the sexes and according to immunisation.
The main purpose of the data is to allow quantitative analysis of the differences in the risk of serious COVID-19 disease between vaccinated and non-vaccinated individuals.
A more detailed description of the data and remarks on the comparability of the occurrences of different population groups can be found in the graphs compiled from the data.
Graphs compiled from the data
The dimensions and indicators of the data are described below. Further technical information about the content of the data is available on the statistics cube.
Data cube: Effectiveness of coronavirus vaccinations in Finland
Indicators
Note! The standardisation of incidence by age and calendar month is described in connection with the graphs compiled from the data (link above).
| Indicator | Technical ID | SID | Description | Source |
|---|---|---|---|---|
| Follow-up period (months / 100,000 persons) |
personmonths | 650911 | Number of follow-up months. One follow-up month equals to 30 follow-up days. |
Population Information System |
| Number of infections requiring hospitalisation |
inpatient_n | 639169 | Number of people in specialised inpatient care due to COVID-19. The information is based on the inpatient treatment periods of the treatment notification register, where the patient has a confirmed COVID-19 infection in the Infectious Diseases Register within -7 /+ 14 days of the treatment period and at least one of the treatment period diagnosis codes indicates COVID-19, respiratory infection or serious complications. | National Infectious Diseases Register |
| Incidence of infections requiring hospitalisation (per month / 100,000 persons) | inpatient_rate_adj | 642065 | Age- and calendar-month-standardised incidence of COVID-19 in inpatients in specialised medical treatment. | Population Information System National Infectious Diseases Register Care Register for Health Care |
| Number of infections requiring intensive care |
icu_n | 639171 | Number of COVID-19 certified patients in intensive care. The information is based on COVID-19 certified coded intensive care units of the Intensive Care Quality Register (COVID-19), in which the patient also has a confirmed COVID-19 infection from the Infectious Diseases Register within -7/+ 28 days from the date of treatment. | National Infectious Diseases Register |
| Incidence of infections requiring intensive care (per month / 100,000 persons) | icu_rate_adj | 642062 | Age- and calendar-month-standardized incidence of those in COVID-19 intensive care. |
Population Information System National Infectious Diseases Register Intensive care quality register |
| Deaths related to a COVID-19 infection, number | death_n | 639168 | Number of patients who have died within 30 days of a COVID-19 infection. Please note that an evaluation of the cause of death has not been made. | Population Information System National Infectious Diseases Register |
| Deaths related to a COVID-19 infection (per month / 100,000 persons) | death_rate_adj | 642064 | Age- and calendar-month-adjusted mortality associated with COVID-19 infection. | Population Information System National Infectious Diseases Register |
| Number of COVID-19 infections | case_n | 639170 | Number of COVID-19 infections | National Infectious Diseases Register |
| Incidence of COVID-19 infections (per month / 100,000 persons) | case_rate_adj | 642063 | Age- and calendar-month standardised incidence of COVID-19 infections. | Population Information System |
Dimensions
Dimensions describe the dimensions (classifying variables) according to which data can be presented. Each dimension is divided into one or more levels that allow you to tabulate the desired views of the data you are viewing.
The dimensions and levels found in the cube interface and API are described in the table below.
| Dimension | Dimension ID | Level | Level ID | Root node ID (SID) | Description |
|---|---|---|---|---|---|
| Age | inciagegroup | Age group | agegroup | Age group in the monitored month: 12-29, 30-49, 50-69, 70+ | |
| - | - | Age groups together | root | 639348 | - |
| Vaccination cover | incivacstatus | Vaccination cover | status | - | Check the About section (in the context of graphs compiled from the data) |
| - | - | Hela befolkningen | root | 639350 | - |
| Gender | incisex | Gender | incisex | Men, Women | |
| - | - | All sexes | root | 639342 | - |
| Time | quadrimestermonth | Month | month | - | A month-long period, e.g. January 2021 |
| - | - | Tertiary | quadrimester | A four-month-long period, e.g. from 1 January 2021 to 30 April 2021 | |
| - | - | All months | root | 642723 | - |
Combinations that can be reviewed
Not all possible combinations of data is available for data protection and content reasons. The following combinations can be retrieved from the open data interface and viewed from the data cube interface:
| Age | Vaccination cover | Gender | Time |
|---|---|---|---|
| root/agegroup | root/status | root | quadrimester/month |
| root | root/status | root/agegroup | quadrimester |
The material does not provide any information calculated over the entire period due to content reasons. Sex-specific data is only available on a tertiary basis on different immunisations. Age and sex-specific data is not shown at all due to data protection reasons.
API logic
Via the interface, data can be retrieved in either CVS or JSON-stat format.
The API is built on dimensions, which are divided into <dimensiotunniste> - <solmutunniste> (id-sid) pairs. Of these, the id is text and the sid is a number series. They are separated with a hyphen (-). By selecting one or more id-sid pairs, the view that is under review is selected.
You can find a JSON format list of all available id-root pairs at: APIADDRESS.dimensions.json
The actual data is accessible at the address provided in this format:
<APIADDRESS>?row=<DIMENSION1 ID>-<SID>&column=<DIMENSIONS2 ID>-<SID>&filter=measure-<INDICATOR ID>.
The necessary number of id-sid pairs can be added to the row and column variables and the filter in the selected indicator. In the dimension and gauge table, you will find the technical identifiers for the dimensions and the identifiers for the root nodes.
By default, the interface returns the values of the level corresponding to the selected ID-SID pairs and the values of all immediate 'children'. For example, if the ID-SID identifies the root level of the dimension (row sum, all), the row sum and the next finest data are returned by default. The search can be limited to the values of the selected node by adding a period (.) after the SID.
In addition to JSON-stat format, it is also possible to retrieve data in CSV format via the API. You can do this simply by replacing 'json' with 'csv'.
Further information on the JSON-stat format
Contact information:
Contacts and inquiries regarding the material can be sent to:
epidemia.avoindata(at)thl.fi
Feedback on the THL cube interface and the open data API can be sent to:
tietojarjestelmat(at)thl.fi
