COVID-19 Dashboard Source Data

Files

File Model Description
COVID19Cases_geoRegion.(json/csv) DailyIncomingData Daily record timelines by geoRegion for cases.
DEPRECATED COVID19Cases_vaccpersons.(json/csv) DailyCasesVaccPersonsIncomingData Daily record timelines for cases of fully vaccinated persons by vaccine. Data only available for geoRegion CHFL. This file has been deprecated and will no longer be updated after 11.11.2021.
COVID19Hosp_geoRegion.(json/csv) DailyIncomingData Daily record timelines by geoRegion for hospitalisations.
COVID19Hosp_vaccpersons.(json/csv) DailyHospVaccPersonsIncomingData Daily record timelines for hospitalisations of fully vaccinated persons by vaccine. Data only available for geoRegion CHFL.
COVID19Death_geoRegion.(json/csv) DailyIncomingData Daily record timelines by geoRegion for deaths.
COVID19Death_vaccpersons.(json/csv) DailyDeathVaccPersonsIncomingData Daily record timelines for deaths of fully vaccinated persons by vaccine. Data only available for geoRegion CHFL.
COVID19Test_geoRegion_all.(json/csv) DailyIncomingData Daily record timelines by geoRegion for tests (all test types combined).
COVID19Test_geoRegion_PCR_Antigen.(json/csv) DailyIncomingData Daily record timelines by geoRegion and test type (pcr/antigen) for tests.
COVID19Cases_geoRegion_w.(json/csv) WeeklyIncomingData Iso-Week record timelines by geoRegion for cases.
COVID19Hosp_geoRegion_w.(json/csv) WeeklyIncomingData Iso-Week record timelines by geoRegion for hospitalisations.
COVID19Death_geoRegion_w.(json/csv) WeeklyIncomingData Iso-Week record timelines by geoRegion for deaths.
COVID19Test_geoRegion_w.(json/csv) WeeklyIncomingData Iso-Week record timelines by geoRegion for tests.
COVID19Test_geoRegion_PCR_Antigen_w.(json/csv) WeeklyIncomingData Iso-Week record timelines by geoRegion and test type (pcr/antigen) for tests.
COVID19Cases_geoRegion_AKL10_w.(json/csv) WeeklyIncomingData Iso-Week record timelines by geoRegion and age brackets for cases.
DEPRECATED COVID19Cases_vaccpersons_AKL10_w.(json/csv) WeeklyCasesVaccPersonsAgeRangeIncomingData Iso-Week record timelines for cases of fully vaccinated persons by vaccine and age brackets. Data only available for geoRegion CHFL. This file has been deprecated and will no longer be updated after 11.11.2021.
COVID19Hosp_geoRegion_AKL10_w.(json/csv) WeeklyIncomingData Iso-Week record timelines by geoRegion and age brackets for hospitalisations.
COVID19Hosp_reason_AKL10_w.(json/csv) WeeklyHospReasonIncomingData Iso-Week record timelines for hospitalisations by geoRegion, age brackets and primary hospitalisation reason.
COVID19Hosp_vaccpersons_AKL10_w.(json/csv) WeeklyHospVaccPersonsAgeRangeIncomingData Iso-Week record timelines for hospitalisations of fully vaccinated persons by vaccine and age brackets. Data only available for geoRegion CHFL.
COVID19Death_geoRegion_AKL10_w.(json/csv) WeeklyIncomingData Iso-Week record timelines by geoRegion and age brackets for deaths.
COVID19Death_vaccpersons_AKL10_w.(json/csv) WeeklyDeathVaccPersonsAgeRangeIncomingData Iso-Week record timelines for deaths of fully vaccinated persons by vaccine and age brackets. Data only available for geoRegion CHFL.
COVID19Test_geoRegion_AKL10_w.(json/csv) WeeklyIncomingData Iso-Week record timelines by geoRegion and age brackets for tests (all test types).
COVID19Cases_geoRegion_sex_w.(json/csv) WeeklyIncomingData Iso-Week record timelines by geoRegion and sex for cases.
DEPRECATED COVID19Cases_vaccpersons_sex_w.(json/csv) WeeklyCasesVaccPersonsSexIncomingData Iso-Week record timelines for cases of fully vaccinated persons by vaccine and sex. Data only available for geoRegion CHFL. This file has been deprecated and will no longer be updated after 11.11.2021.
COVID19Hosp_geoRegion_sex_w.(json/csv) WeeklyIncomingData Iso-Week record timelines by geoRegion and sex for hospitalisations.
COVID19Hosp_vaccpersons_sex_w.(json/csv) WeeklyHospVaccPersonsSexIncomingData Iso-Week record timelines for hospitalisations of fully vaccinated persons by vaccine and sex. Data only available for geoRegion CHFL.
COVID19Death_geoRegion_sex_w.(json/csv) WeeklyIncomingData Iso-Week record timelines by geoRegion and sex for deaths.
COVID19Death_vaccpersons_sex_w.(json/csv) WeeklyDeathVaccPersonsSexIncomingData Iso-Week record timelines for deaths of fully vaccinated persons by vaccine and sex. Data only available for geoRegion CHFL.
COVID19Test_geoRegion_sex_w.(json/csv) WeeklyIncomingData Iso-Week record timelines by geoRegion and sex for tests (all test types).
COVID19WeeklyReportText.(json/csv) WeeklyReportIncomingData Weekly report texts by Iso-Week.
COVID19Cases_extraGeoRegions_d.(json/csv) AdditionalGeoRegionDailyIncomingData Daily record timelines by (additonal) geographical units for cases. Contains data for CH, cantons, greater regions & greater labor market regions.
COVID19Cases_extraGeoRegions_14d.(json/csv) AdditionalGeoRegion14dPeriodIncomingData 14d aggregated record timelines by (additional) geographical units for cases. Contains data for CH, labor market regions & districts.
DEPRECATED COVID19EvalTextDaily.(json/csv) DailyReportIncomingData Optional extra texts for daily report (PDF). This file has been deprecated and will no longer be updated after 05.04.2022.
DEPRECATED COVID19QuarantineIsolation_geoRegion_d.(json/csv) ContactTracingIncomingData Contact tracing data (current record by geoRegion where available). This file has been deprecated and will no longer be updated after 05.04.2022.
COVID19HospCapacity_geoRegion.(json/csv) HospCapacityDailyIncomingData Daily hospital capacity data timelines by geoRegion.
COVID19HospCapacity_geoRegion_certStatus.(json/csv) HospCapacityCertStatusIncomingData Daily hospital capacity data timelines of certified/ad-hoc status of operational ICU beds by geoRegion.
COVID19HospCapacity_geoRegion_w.(json/csv) HospCapacityWeeklyIncomingData Weekly hospital capacity data timelines by geoRegion.
DEPRECATED COVID19IntQua.(json/csv) InternationalQuarantineIncomingData International quarantine data (mandatory quarantine requirement when entering Switzerland). This file has been deprecated and will no longer be updated after 05.04.2022.
DEPRECATED COVID19IntCases.(json/csv) InternationalDailyIncomingData International daily data (cases). This file has been deprecated and will no longer be updated after 05.04.2022.
DEPRECATED COVID19Re_geoRegion.(json/csv) ReDailyIncomingData Daily Re value data timelines by geoRegion. This file has been deprecated and will no longer be updated after 05.04.2022.
DEPRECATED COVID19VaccDosesDelivered.(json/csv) VaccinationIncomingData Vaccine doses delivered/received data by geoRegion. This file has been deprecated and will no longer be updated after 26.04.2022.
DEPRECATED COVID19VaccDosesDelivered_vaccine.(json/csv) VaccinationDosesReceivedDeliveredVaccineIncomingData Vaccine doses delivered/received data by geoRegion and vaccine (type). This file has been deprecated and will no longer be updated after 26.04.2022.
COVID19VaccDosesAdministered.(json/csv) VaccinationIncomingData Vaccine doses administered data by geoRegion.
COVID19AdministeredDoses_vaccine.(json/csv) VaccinationVaccineIncomingData Vaccine doses administered data by geoRegion and vaccine (type).
COVID19VaccPersons_v2.(json/csv) VaccPersonsIncomingData Vaccinated persons data by geoRegion (aggregated by canton/country of residence).
COVID19VaccPersons_vaccine.(json/csv) VaccPersonsVaccineIncomingData Vaccinated persons data by geoRegion (aggregated by canton/country of residence) and vaccine (type).
COVID19VaccDosesAdministered_AKL10_w.(json/csv) VaccinationWeeklyIncomingData Iso-Week record timelines by geoRegion and age brackets for vaccine doses administered.
COVID19VaccPersons_AKL10_w_v2.(json/csv) VaccPersonsWeeklyIncomingData Iso-Week record timelines by geoRegion (aggregated by canton/country of residence) and age brackets for vaccinated persons.
COVID19VaccPersons_AKL10_vaccine_w.(json/csv) VaccPersonsWeeklyAgeRangeVaccineIncomingData Iso-Week record timelines by geoRegion (aggregated by canton/country of residence), age brackets and vaccine for vaccinated persons.
COVID19VaccDosesAdministered_sex_w.(json/csv) VaccinationWeeklyIncomingData Iso-Week record timelines by geoRegion and sex for vaccine doses administered.
COVID19VaccPersons_sex_w_v2.(json/csv) VaccPersonsWeeklyIncomingData Iso-Week record timelines by geoRegion (aggregated by canton/country of residence) and sex for vaccinated persons.
COVID19FullyVaccPersons_indication_w_v2.(json/csv) VaccPersonsWeeklyIndicationIncomingData Iso-Week record timelines by geoRegion (aggregated by canton/country of residence) and vacc indication (reason) for fully vaccinated persons.
COVID19VaccDosesAdministered_indication_w.(json/csv) VaccinationWeeklyIndicationIncomingData Iso-Week record timelines by geoRegion and vacc indication (reason) for vaccine doses administered.
DEPRECATED COVID19VaccDosesAdministered_location_w.(json/csv) VaccinationWeeklyLocationIncomingData Iso-Week record timelines by geoRegion and location for vaccine doses administered. This file has been deprecated and will no longer be updated after 26.04.2022.
DEPRECATED COVID19VaccSymptoms.(json/csv) VaccinationSymptomsIncomingData Data for suspected cases of adverse vaccination reactions based on reports from Swissmedic. This file has been deprecated and will no longer be updated after 26.04.2022.
DEPRECATED COVID19VaccDosesContingent.(json/csv) VaccinationContingentIncomingData Allotted vaccination doses contingent data by geoRegion. This file has been deprecated and will no longer be updated after 10.03.2022.
COVID19Variants_wgs.(json/csv) VirusVariantsWgsDailyIncomingData Virus variant data by geoRegion (source WGS & MSys).
DEPRECATED COVID19Certificates.(json/csv) CovidCertificatesDailyIncomingData Issued COVID certificates data. This file has been deprecated and will no longer be updated after 08.03.2022.
COVID19EpiRawData_d.(json/csv) DailyEpiRawIncomingData Combined daily record timelines for cases, hosp & death by geoRegion. Minimal content without pre-calculated values.
COVID19CasesRawData_AKL10_d.(json/csv) DailyCasesAgeRangeRawIncomingData Daily record timelines for cases by geoRegion and age brackets. Minimal content without pre-calculated values.
COVID19EpiRawData_AKL10_sex_w.(json/csv) WeeklyEpiAgeRangeSexRawIncomingData Combined Iso-Week record timelines for cases, hosp & deaths by geoRegion, age brackets and sex. Minimal content without pre-calculated values.
PopulationAgeRangeSexData.(json/csv) PopulationAgeRangeSexData Population data by geoRegion (cantons + FL), age brackets & sex.

Schema

Check the sources.schema.json file for schema information (only json-schema format for now).

Please note that the data schema can change in the future and be released in a new version. Changes will be tracked here and the current schema version can be read from the data context (see section Download Automation below).

Upcoming Releases

There are currently no planned releases.

Releases

v.0.23.0

Released: 26.04.2022
Description:

v.0.22.0

Released: 05.04.2022
Description:

v.0.21.1

Released: 10.03.2022
Description:

v.0.21.0

Released: 15.02.2021
Description:

v.0.20.0

Released: 03.02.2022
Description:

v.0.19.1

Released: 01.02.2022
Description:

v.0.19.0

Released: 20.01.2022
Description:

v.0.18.4

Released: 14.01.2022
Description:

v.0.18.3

Released: 23.12.2021
Description:

v.0.18.2

Released: 16.12.2021
Description:

v.0.18.1

Released: 07.12.2021
Description:

v.0.18.0

Released: 02.12.2021
Description:

v.0.17.4

Released: 18.11.2021
Description:

v.0.17.3

Released: 11.11.2021
Description:

v.0.17.2

Released: 28.10.2021
Description:

v.0.17.1

Released: 19.10.2021
Description:

v.0.17.0

Released: 07.10.2021
Description:

cases, hosp & death data by vaccination status

v.0.16.4

Released: 05.10.2021
Description:

v.0.16.3

Released: 24.09.2021
Description:

v.0.16.2

Released: 13.09.2021
Description:

v.0.16.1

Released: 20.08.2021
Description:

v.0.16.0

Released: 05.08.2021
Description:

cases, hosp & death data of fully vaccinated persons

difference to previous day

cleanup

v.0.15.0

Released: 27.07.2021
Description:

v.0.14.0

Released: 16.07.2021
Description:

v.0.13.0

Released: 21.06.2021
Description:

v.0.12.0

Released: 17.06.2021
Description:

v.0.11.0

Released: 14.06.2021
Description:

v.0.10.0

Released: 08.06.2021
Description:

v.0.9.0

Released: 25.05.2021
Description:

v.0.8.0

Released: 18.05.2021
Description:

v.0.7.0

Released: 11.05.2021
Description:

v.0.6.0

Released: 04.05.2021
Description:

v.0.5.0

Released: 29.04.2021
Description:

v.0.4.6

Released: 26.04.2021
Description:

v.0.4.5

Released: 19.04.2021
Description:

v.0.4.4

Released: 25.03.2021
Description:

v.0.4.3

Released: 19.03.2021
Description:

v.0.4.2

Released: 26.02.2021
Description:

v.0.4.1

Released: 23.02.2021
Description:

v.0.4.0

Released: 18.02.2021
Description:

v.0.3.3

Released: 16.02.2021
Description:

v.0.3.2

Released: 05.02.2021
Description:

v.0.3.1

Released: 28.01.2021
Description:

v.0.3.0

Released: 13.01.2021
Description:

v.0.2.0

Released: 17.12.2020
Description:

v0.1.2

Released: 15.12.2020

Description:

v0.1.1

Released: 20.11.2020

Description:

v0.1.0

Released: 05.11.2020

Description: Initial version

Data Context API

Current Data Context

The current data context can be queried at a static location and provides information about the source date of the current data and source file locations.

GET https://www.covid19.admin.ch/api/data/context

Data Model

sourceDate contains the overall source date of the data. Multiple publications per day are possible with the same sourceDate. Check the dataVersion to decide if you need to update your data.

nextScheduledPublication contains the next scheduled publication date

dataVersion contains the current data version. Download links may be generated directly using the dataVersion but using the pre-generated urls in the sources field (see documentation below) is recommended.

sources contains information about the source location of all currently available raw source data (zip and individual files) to download as well as the schema version/content. OpenData DCAT-AP-CH metadata information will be published in the future in addition to this API to further facilitate automation of data downloads.

{
  "sources": {
    "schema": {
      "version": "{current-schema-version}",
      "jsonSchema": "{current-schema-location-url}"
    },
    "readme": "{current-readme-location-url}",
    "zip": {
      "json": "{current-source-location-url}",
      "csv": "{current-source-location-url}"
    },
    "individual": {
      "json": {
        "daily": {
          "cases": "{current-source-location-url}",
          "hosp": "{current-source-location-url}",
          "death": "{current-source-location-url}",
          "test": "{current-source-location-url}",
          "testPcrAntigen": "{current-source-location-url}",
          "hospCapacity": "{current-source-location-url}",
          "re": "{current-source-location-url}",
          "intCases": "{current-source-location-url}"
        },
        "weekly": {
          "byAge": {
            "cases": "{current-source-location-url}",
            "hosp": "{current-source-location-url}",
            "death": "{current-source-location-url}",
            "test": "{current-source-location-url}"
          },
          "bySex": {
            "cases": "{current-source-location-url}",
            "hosp": "{current-source-location-url}",
            "death": "{current-source-location-url}",
            "test": "{current-source-location-url}"
          },
          "default": {
            "cases": "{current-source-location-url}",
            "hosp": "{current-source-location-url}",
            "death": "{current-source-location-url}",
            "test": "{current-source-location-url}"
          },
        },
        "dailyReport": "{current-source-location-url}",
        "contactTracing": "{current-source-location-url}",
        "intQua": "{current-source-location-url}"
      },
      "csv": {
        "daily": {
          "cases": "{current-source-location-url}",
          "hosp": "{current-source-location-url}",
          "death": "{current-source-location-url}",
          "test": "{current-source-location-url}",
          "testPcrAntigen": "{current-source-location-url}",
          "hospCapacity": "{current-source-location-url}",
          "re": "{current-source-location-url}",
          "intCases": "{current-source-location-url}"
        },
        "weekly": {
          "byAge": {
            "cases": "{current-source-location-url}",
            "hosp": "{current-source-location-url}",
            "death": "{current-source-location-url}",
            "test": "{current-source-location-url}"
          },
          "bySex": {
            "cases": "{current-source-location-url}",
            "hosp": "{current-source-location-url}",
            "death": "{current-source-location-url}",
            "test": "{current-source-location-url}"
          },
          "default": {
            "cases": "{current-source-location-url}",
            "hosp": "{current-source-location-url}",
            "death": "{current-source-location-url}",
            "test": "{current-source-location-url}"
          },
        },
        "dailyReport": "{current-source-location-url}",
        "contactTracing": "{current-source-location-url}",
        "intQua": "{current-source-location-urxl}"
      }
    }
  }
}

Data Context History

The data context history can be queried at a static location and provides a list of previously published data contexts.

GET https://www.covid19.admin.ch/api/data/context/history

Multiple publications per day are possible due to delays or data corrections etc. By default only the latest data context per day is returned from the API. Query https://www.covid19.admin.ch/api/data/context/history/full for all previously published data contexts (multiple per day returned).

Data Model

current Url pointing to the current data context.

documentation Url of this documentation

dataContexts List of the individual data context history items

Data Model (individual data context history item)

date Day of the publication, formatted as YYYY-MM-DD (e.g. 2021-03-18)

latest Multiple publications per day are possible due to delays or data corrections etc. This property indicates if the current data context is the latest one published for this day.

published Date and time of publication formatted as ISO 8601 string (e.g. 2021-03-18T13:30:35+01:00)

dataVersion Data version of thsi dataContext (see documentation above for details)

dataContextUrl Url pointing to the full data context object.

{
    "current": "https://www.covid19.admin.ch/api/data/context",
    "documentation": "https://www.covid19.admin.ch/api/data/documentation#data-context-history",
    "dataContexts: [
        {
            "date": "2021-03-18",
            "published": "2021-03-18T13:30:35+01:00",
            "latest": true,
            "dataVersion": "20210318-dec0fnrh",
            "dataContextUrl": "https://www.covid19.admin.ch/api/data/20210318-dec0fnrh/context"
        }
    ]
}