Robert Koch-Institut COVID-19 API - von Marlon Lückert

# Germany

# /germany

# Request

GET https://api.corona-zahlen.org/germany Open

# Response

{
  "cases": 34758889,
  "deaths": 151629,
  "recovered": 33017819,
  "weekIncidence": 687.4708933960765,
  "casesPer100k": 41758.877925671724,
  "casesPerWeek": 572231,
  "delta": {
    "cases": 150052,
    "deaths": 209,
    "recovered": 81111,
    "weekIncidence": 6.611232747541408
  },
  "r": {
    "value": 0.82,
    "rValue4Days": { "value": 0.82, "date": "2022-10-14T00:00:00.000Z" },
    "rValue7Days": { "value": 0.85, "date": "2022-10-13T00:00:00.000Z" },
    "lastUpdate": "2022-10-18T02:22:19.000Z"
  },
  "hospitalization": {
    "cases7Days": 9921,
    "incidence7Days": 11.92,
    "date": "2022-10-18T00:00:00.000Z",
    "lastUpdate": "2022-10-18T03:05:26.000Z"
  },
  "meta": {
    "source": "Robert Koch-Institut",
    "contact": "Marlon Lueckert ([email protected])",
    "info": "https://github.com/marlon360/rki-covid-api",
    "lastUpdate": "2022-10-18T00:00:00.000Z",
    "lastCheckedForUpdate": "2022-10-18T20:23:10.902Z"
  }
}

# /germany/history

Redirects to /germany/history/cases

# /germany/history/cases

Returns the total cases in germany for every day.

# Request

GET https://api.corona-zahlen.org/germany/history/cases Open

# Response

{
  "data": [
    {
      "cases": 2,
      "date": "2020-01-01T00:00:00.000Z"
    },
    {
      "cases": 5,
      "date": "2020-01-02T00:00:00.000Z"
    },
    // ...
    {
      "cases": 5409,
      "date": "2021-01-03T00:00:00.000Z"
    }
  ],
  "meta": {
    "source": "Robert Koch-Institut",
    "contact": "Marlon Lueckert ([email protected])",
    "info": "https://github.com/marlon360/rki-covid-api",
    "lastUpdate": "2021-01-03T00:00:00.000Z",
    "lastCheckedForUpdate": "2021-01-04T13:20:30.694Z"
  }
}

# /germany/history/cases/:days

Returns the total cases in germany for the last :days days.

# Request

GET https://api.corona-zahlen.org/germany/history/cases/7 Open

Parameters

Parameter Description
:days Number of days in the past from today

# Response

{
  "data": [
    {
      "cases": 15587,
      "date": "2020-12-28T00:00:00.000Z"
    },
    {
      "cases": 27130,
      "date": "2020-12-29T00:00:00.000Z"
    },
    {
      "cases": 30295,
      "date": "2020-12-30T00:00:00.000Z"
    },
    {
      "cases": 18902,
      "date": "2020-12-31T00:00:00.000Z"
    },
    {
      "cases": 10031,
      "date": "2021-01-01T00:00:00.000Z"
    },
    {
      "cases": 8540,
      "date": "2021-01-02T00:00:00.000Z"
    },
    {
      "cases": 5409,
      "date": "2021-01-03T00:00:00.000Z"
    }
  ],
  "meta": {
    "source": "Robert Koch-Institut",
    "contact": "Marlon Lueckert ([email protected])",
    "info": "https://github.com/marlon360/rki-covid-api",
    "lastUpdate": "2021-01-03T00:00:00.000Z",
    "lastCheckedForUpdate": "2021-01-04T13:26:36.595Z"
  }
}

# /germany/history/incidence

Returns the history of week incidences in germany.

# Request

GET https://api.corona-zahlen.org/germany/history/incidence Open

# Response

{
  "data": [
    {
      "weekIncidence": 162.7502138445754,
      "date": "2021-01-13T00:00:00.000Z"
    },
    {
      "weekIncidence": 155.7810792830319,
      "date": "2021-01-14T00:00:00.000Z"
    },
    {
      "weekIncidence": 148.2901013122907,
      "date": "2021-01-15T00:00:00.000Z"
    },
    {
      "weekIncidence": 144.20914156386442,
      "date": "2021-01-16T00:00:00.000Z"
    },
    {
      "weekIncidence": 141.81034524739113,
      "date": "2021-01-17T00:00:00.000Z"
    },
    {
      "weekIncidence": 131.50093190531484,
      "date": "2021-01-18T00:00:00.000Z"
    }
  ],
  "meta": {
    "source": "Robert Koch-Institut",
    "contact": "Marlon Lueckert ([email protected])",
    "info": "https://github.com/marlon360/rki-covid-api",
    "lastUpdate": "2021-01-18T00:00:00.000Z",
    "lastCheckedForUpdate": "2021-01-19T10:58:20.854Z"
  }
}

# /germany/history/incidence/:days

Returns the week incidence in germany for the last :days days.

# Request

GET https://api.corona-zahlen.org/germany/history/incidence/3 Open

Parameters

Parameter Description
:days Number of days in the past from today

# Response

{
  "data": [
    {
      "weekIncidence": 144.20914156386442,
      "date": "2021-01-16T00:00:00.000Z"
    },
    {
      "weekIncidence": 141.81034524739113,
      "date": "2021-01-17T00:00:00.000Z"
    },
    {
      "weekIncidence": 131.50093190531484,
      "date": "2021-01-18T00:00:00.000Z"
    }
  ],
  "meta": {
    "source": "Robert Koch-Institut",
    "contact": "Marlon Lueckert ([email protected])",
    "info": "https://github.com/marlon360/rki-covid-api",
    "lastUpdate": "2021-01-18T00:00:00.000Z",
    "lastCheckedForUpdate": "2021-01-19T11:02:29.069Z"
  }
}

# /germany/history/deaths

Returns the number of deaths in germany for every day.

# Request

GET https://api.corona-zahlen.org/germany/history/deaths Open

# Response

{
  "data": [
    {
      "deaths": 0,
      "date": "2020-01-01T00:00:00.000Z"
    },
    {
      "cases": 1,
      "date": "2020-01-02T00:00:00.000Z"
    },
    // ...
    {
      "deaths": 100,
      "date": "2021-01-03T00:00:00.000Z"
    }
  ],
  "meta": {
    "source": "Robert Koch-Institut",
    "contact": "Marlon Lueckert ([email protected])",
    "info": "https://github.com/marlon360/rki-covid-api",
    "lastUpdate": "2021-01-03T00:00:00.000Z",
    "lastCheckedForUpdate": "2021-01-04T13:20:30.694Z"
  }
}

# /germany/history/deaths/:days

Returns the number of deaths in germany for the last :days days.

# Request

GET https://api.corona-zahlen.org/germany/history/deaths/7 Open

Parameters

Parameter Description
:days Number of days in the past from today

# Response

{
  "data": [
    {
      "deaths": 171,
      "date": "2020-12-28T00:00:00.000Z"
    },
    {
      "deaths": 199,
      "date": "2020-12-29T00:00:00.000Z"
    },
    {
      "deaths": 141,
      "date": "2020-12-30T00:00:00.000Z"
    },
    {
      "deaths": 57,
      "date": "2020-12-31T00:00:00.000Z"
    },
    {
      "deaths": 28,
      "date": "2021-01-01T00:00:00.000Z"
    },
    {
      "deaths": 17,
      "date": "2021-01-02T00:00:00.000Z"
    },
    {
      "deaths": 7,
      "date": "2021-01-03T00:00:00.000Z"
    }
  ],
  "meta": {
    "source": "Robert Koch-Institut",
    "contact": "Marlon Lueckert ([email protected])",
    "info": "https://github.com/marlon360/rki-covid-api",
    "lastUpdate": "2021-01-03T00:00:00.000Z",
    "lastCheckedForUpdate": "2021-01-04T13:29:52.846Z"
  }
}

# /germany/history/recovered

Returns the number of recovered people in germany for every day.

# Request

GET https://api.corona-zahlen.org/germany/history/recovered Open

# Response

{
  "data": [
    {
      "recovered": 0,
      "date": "2020-01-01T00:00:00.000Z"
    },
    {
      "recovered": 1,
      "date": "2020-01-02T00:00:00.000Z"
    },
    // ...
    {
      "recovered": 100,
      "date": "2021-01-03T00:00:00.000Z"
    }
  ],
  "meta": {
    "source": "Robert Koch-Institut",
    "contact": "Marlon Lueckert ([email protected])",
    "info": "https://github.com/marlon360/rki-covid-api",
    "lastUpdate": "2021-01-03T00:00:00.000Z",
    "lastCheckedForUpdate": "2021-01-04T13:20:30.694Z"
  }
}

# /germany/history/recovered/:days

Returns the number of recovered people in germany for the last :days days.

# Request

GET https://api.corona-zahlen.org/germany/history/recovered/7 Open

Parameters

Parameter Description
:days Number of days in the past from today

# Response

{
  "data": [
    {
      "recovered": 1638,
      "date": "2020-12-28T00:00:00.000Z"
    },
    {
      "recovered": 1546,
      "date": "2020-12-29T00:00:00.000Z"
    },
    {
      "recovered": 1059,
      "date": "2020-12-30T00:00:00.000Z"
    },
    {
      "recovered": 317,
      "date": "2020-12-31T00:00:00.000Z"
    },
    {
      "recovered": 185,
      "date": "2021-01-01T00:00:00.000Z"
    },
    {
      "recovered": 116,
      "date": "2021-01-02T00:00:00.000Z"
    },
    {
      "recovered": 49,
      "date": "2021-01-03T00:00:00.000Z"
    }
  ],
  "meta": {
    "source": "Robert Koch-Institut",
    "contact": "Marlon Lueckert ([email protected])",
    "info": "https://github.com/marlon360/rki-covid-api",
    "lastUpdate": "2021-01-03T00:00:00.000Z",
    "lastCheckedForUpdate": "2021-01-04T13:31:15.304Z"
  }
}

# /germany/history/rValue

Returns the R value of germany for every day.

# /germany/history/rValue/:days

Returns the R value of germany for the last :days days.

Note: The data is always 4 days behind.

# Request

GET https://api.corona-zahlen.org/germany/history/rValue/10 Open

Parameters

Parameter Description
:days Number of days in the past from today

# /germany/age-groups

# Request

GET https://api.corona-zahlen.org/germany/age-groups Open

# Response

{
  "data": {
    "A00-A04": {
      "casesMale": 64370,
      "casesFemale": 59621,
      "deathsMale": 4,
      "deathsFemale": 9,
      "casesMalePer100k": 3161.5,
      "casesFemalePer100k": 3084.3,
      "deathsMalePer100k": 0.2,
      "deathsFemalePer100k": 0.5,
      "hospitalization": {
        "cases7Days": 47,
        "incidence7Days": 47,
        "date": "2021-10-25T00:00:00.000Z"
      }
    },
    "A05-A14": {
      "casesMale": 213364,
      "casesFemale": 195741,
      "deathsMale": 3,
      "deathsFemale": 4,
      "casesMalePer100k": 5527.2,
      "casesFemalePer100k": 5365.1,
      "deathsMalePer100k": 0.1,
      "deathsFemalePer100k": 0.1,
      "hospitalization": {
        "cases7Days": 37,
        "incidence7Days": 37,
        "date": "2021-10-25T00:00:00.000Z"
      }
    },
    "A15-A34": {
      "casesMale": 686975,
      "casesFemale": 671273,
      "deathsMale": 143,
      "deathsFemale": 84,
      "casesMalePer100k": 6998.9,
      "casesFemalePer100k": 7371.9,
      "deathsMalePer100k": 1.5,
      "deathsFemalePer100k": 0.9,
      "hospitalization": {
        "cases7Days": 273,
        "incidence7Days": 273,
        "date": "2021-10-25T00:00:00.000Z"
      }
    },
    "A35-A59": {
      "casesMale": 803350,
      "casesFemale": 848158,
      "deathsMale": 3107,
      "deathsFemale": 1314,
      "casesMalePer100k": 5568.9,
      "casesFemalePer100k": 5955.9,
      "deathsMalePer100k": 21.5,
      "deathsFemalePer100k": 9.2,
      "hospitalization": {
        "cases7Days": 510,
        "incidence7Days": 510,
        "date": "2021-10-25T00:00:00.000Z"
      }
    },
    "A60-A79": {
      "casesMale": 296636,
      "casesFemale": 299046,
      "deathsMale": 18665,
      "deathsFemale": 9890,
      "casesMalePer100k": 3446.9,
      "casesFemalePer100k": 3132.2,
      "deathsMalePer100k": 216.9,
      "deathsFemalePer100k": 103.6,
      "hospitalization": {
        "cases7Days": 727,
        "incidence7Days": 727,
        "date": "2021-10-25T00:00:00.000Z"
      }
    },
    "A80+": {
      "casesMale": 104741,
      "casesFemale": 202238,
      "deathsMale": 28173,
      "deathsFemale": 33576,
      "casesMalePer100k": 4587.5,
      "casesFemalePer100k": 5535.9,
      "deathsMalePer100k": 1233.9,
      "deathsFemalePer100k": 919.1,
      "hospitalization": {
        "cases7Days": 709,
        "incidence7Days": 709,
        "date": "2021-10-25T00:00:00.000Z"
      }
    }
  },
  "meta": {
    "source": "Robert Koch-Institut",
    "contact": "Marlon Lueckert ([email protected])",
    "info": "https://github.com/marlon360/rki-covid-api",
    "lastUpdate": "2021-10-25T02:34:17.000Z",
    "lastCheckedForUpdate": "2021-10-25T11:07:33.049Z"
  }
}

# /germany/history/frozen-incidence

# /germany/history/frozen-incidence/:days

# Request

GET https://api.corona-zahlen.org/germany/history/frozen-incidence/7 Open

Parameters

Parameter Description
:days Number of days in the past from today

# Response

{
  "data": {
    "abbreviation": "Bund",
    "name": "Bundesgebiet",
    "history": [
      {
        "weekIncidence": 611.204442863739,
        "date": "2022-10-09T00:00:00.000Z",
        "dataSource": "Official, from Fallzahlen_Kum_Tab_aktuell.xlsx"
      },
      {
        "weekIncidence": 598.102116070228,
        "date": "2022-10-10T00:00:00.000Z",
        "dataSource": "Official, from Fallzahlen_Kum_Tab_aktuell.xlsx"
      },
      {
        "weekIncidence": 787.5055846475,
        "date": "2022-10-11T00:00:00.000Z",
        "dataSource": "Unofficial, calculated from daily RKI Dump"
      },
      {
        "weekIncidence": 799.8810722965,
        "date": "2022-10-12T00:00:00.000Z",
        "dataSource": "Unofficial, calculated from daily RKI Dump"
      },
      {
        "weekIncidence": 793.8368942204,
        "date": "2022-10-13T00:00:00.000Z",
        "dataSource": "Unofficial, calculated from daily RKI Dump"
      },
      {
        "weekIncidence": 760.1343842683,
        "date": "2022-10-14T00:00:00.000Z",
        "dataSource": "Unofficial, calculated from daily RKI Dump"
      },
      {
        "weekIncidence": 731.8585394661,
        "date": "2022-10-15T00:00:00.000Z",
        "dataSource": "Unofficial, calculated from daily RKI Dump"
      }
    ]
  },
  "meta": {
    "source": "Robert Koch-Institut",
    "contact": "Marlon Lueckert ([email protected])",
    "info": "https://github.com/marlon360/rki-covid-api",
    "lastUpdate": "2022-10-15T01:05:53.000Z",
    "lastCheckedForUpdate": "2022-10-15T08:29:17.917Z"
  }
}

# /germany/history/hospitalization

# /germany/history/hospitalization/:days

# Request

GET https://api.corona-zahlen.org/germany/history/hospitalization/7 Open

Parameters

Parameter Description
:days Number of days in the past from today

# Response

cases7Days updated number of hospitalization cases of the last 7 days.

incidence7Days updated 7 day incidence of hospitalization.

date publishing date of all values.

Since 2021-03-09 the RKI is publisching adjusted (predicted) values for cases7Days and incidence7Days. If these values ​​are available, they are output below. These values are unavailable bevor 2021-03-09 and for the last 3 days.

fixedCases7Days the number of 7 day cases witch is published at date first (fixed, that will never change!).

updatedCases7Days the today updated number of 7 day cases and the same as cases7Days.

adjustedLowerCases7Days the 95% lower limit adjusted (predicted) number of 7 day cases.

adjustedCases7Days the adjusted (predicted) number of 7 day cases.

adjustedUpperCases7Days the 95% upper limit adjusted (predicted) number of 7 day cases.

fixedIncidence7Days the 7 day incidence witch is published at date first (fixed, that will never change!).

updatedIncidence7Days the today updated 7 day incidence and the same as incidence7Days.

adjustedLowerIncidence7Days the 95% lower limit adjusted (predicted) 7 day incidence.

adjustedIncidence7Days the adjusted (predicted) 7 day incidence.

adjustedUpperIncidence7Days the 95% upper limit adjusted (predicted) 7 day incidence.

{
  "data": [
    {
      "cases7Days": 7629,
      "incidence7Days": 9.17,
      "date": "2022-02-19T00:00:00.000Z",
      "fixedCases7Days": 5301,
      "updatedCases7Days": 7629,
      "adjustedLowerCases7Days": 9606,
      "adjustedCases7Days": 9840,
      "adjustedUpperCases7Days": 10024,
      "fixedIncidence7Days": 6.37,
      "updatedIncidence7Days": 9.17,
      "adjustedLowerIncidence7Days": 11.55,
      "adjustedIncidence7Days": 11.83,
      "adjustedUpperIncidence7Days": 12.06
    },
    {
      "cases7Days": 7491,
      "incidence7Days": 9.01,
      "date": "2022-02-20T00:00:00.000Z",
      "fixedCases7Days": 5213,
      "updatedCases7Days": 7491,
      "adjustedLowerCases7Days": 9634,
      "adjustedCases7Days": 9866,
      "adjustedUpperCases7Days": 10061,
      "fixedIncidence7Days": 6.27,
      "updatedIncidence7Days": 9.01,
      "adjustedLowerIncidence7Days": 11.59,
      "adjustedIncidence7Days": 11.87,
      "adjustedUpperIncidence7Days": 12.1
    },
    {
      "cases7Days": 7415,
      "incidence7Days": 8.92,
      "date": "2022-02-21T00:00:00.000Z",
      "fixedCases7Days": 5040,
      "updatedCases7Days": 7415,
      "adjustedLowerCases7Days": 9705,
      "adjustedCases7Days": 9936,
      "adjustedUpperCases7Days": 10125,
      "fixedIncidence7Days": 6.06,
      "updatedIncidence7Days": 8.92,
      "adjustedLowerIncidence7Days": 11.67,
      "adjustedIncidence7Days": 11.95,
      "adjustedUpperIncidence7Days": 12.18
    },
    {
      "cases7Days": 7137,
      "incidence7Days": 8.58,
      "date": "2022-02-22T00:00:00.000Z",
      "fixedCases7Days": 5165,
      "updatedCases7Days": 7137,
      "adjustedLowerCases7Days": 9764,
      "adjustedCases7Days": 10003,
      "adjustedUpperCases7Days": 10249,
      "fixedIncidence7Days": 6.21,
      "updatedIncidence7Days": 8.58,
      "adjustedLowerIncidence7Days": 11.74,
      "adjustedIncidence7Days": 12.03,
      "adjustedUpperIncidence7Days": 12.33
    },
    {
      "cases7Days": 6607,
      "incidence7Days": 7.95,
      "date": "2022-02-23T00:00:00.000Z",
      "fixedCases7Days": 5275,
      "updatedCases7Days": 6607,
      "adjustedLowerCases7Days": null,
      "adjustedCases7Days": null,
      "adjustedUpperCases7Days": null,
      "fixedIncidence7Days": 6.34,
      "updatedIncidence7Days": 7.95,
      "adjustedLowerIncidence7Days": null,
      "adjustedIncidence7Days": null,
      "adjustedUpperIncidence7Days": null
    },
    {
      "cases7Days": 6034,
      "incidence7Days": 7.26,
      "date": "2022-02-24T00:00:00.000Z",
      "fixedCases7Days": 5217,
      "updatedCases7Days": 6034,
      "adjustedLowerCases7Days": null,
      "adjustedCases7Days": null,
      "adjustedUpperCases7Days": null,
      "fixedIncidence7Days": 6.27,
      "updatedIncidence7Days": 7.26,
      "adjustedLowerIncidence7Days": null,
      "adjustedIncidence7Days": null,
      "adjustedUpperIncidence7Days": null
    },
    {
      "cases7Days": 5221,
      "incidence7Days": 6.28,
      "date": "2022-02-25T00:00:00.000Z",
      "fixedCases7Days": 5221,
      "updatedCases7Days": 5221,
      "adjustedLowerCases7Days": null,
      "adjustedCases7Days": null,
      "adjustedUpperCases7Days": null,
      "fixedIncidence7Days": 6.28,
      "updatedIncidence7Days": 6.28,
      "adjustedLowerIncidence7Days": null,
      "adjustedIncidence7Days": null,
      "adjustedUpperIncidence7Days": null
    }
  ],
  "meta": {
    "source": "Robert Koch-Institut",
    "contact": "Marlon Lueckert ([email protected])",
    "info": "https://github.com/marlon360/rki-covid-api",
    "lastUpdate": "2022-02-25T04:05:31.000Z",
    "lastCheckedForUpdate": "2022-02-25T06:41:49.840Z"
  }
}

← States →