Our API

Welcome to COVID cases India API! This is our API documentation. These APIs return the count of Covid-19 cases in India. The source of our API is Ministry of Health and Family Welfare, India (MOHFW). If you need any kind of help/support from our side or have any suggestions please reach out to us at saliljain53@gmail.com or vivekkhanna987@gmail.com. Postman collection can be found here

Introduction

The APIs are public and can be used by anyone to create dashboard or for research purposes. Currently we have created 2 APIs

Statewise cases

Lists current date's cured, death and total covid-19 cases. The response is an array of JSON where each element has four keys:

  1. active: Number of active cases
  2. cured: Number of cured cases
  3. deaths: Number of casualties
  4. noOfCases: Total number of cases
  5. state: State name
GET
https://covid-india-cases.herokuapp.com/states/

Example request

$ curl https://covid-india-cases.herokuapp.com/states/

Example response

[
    {
        "active": 1154,
        "cured": 1128,
        "deaths": 24,
        "noOfCases": 2306,
        "state": "Andaman and Nicobar Islands"
    },
    {
        "active": 88138,
        "cured": 191117,
        "deaths": 2562,
        "noOfCases": 281817,
        "state": "Andhra Pradesh"
    },
    {
        "active": 882,
        "cured": 1771,
        "deaths": 5,
        "noOfCases": 2658,
        "state": "Arunachal Pradesh"
    },
    ....
]

Total cases timeline

Lists the total number of cases statewise with respect to time. The response is an array of JSON where each element has multiple dates in the form of YYYY-MM-DD and the last key State UT as the name of the State/UT. The API returns data from 30th January till today

GET
https://covid-india-cases.herokuapp.com/statetimeline/

Example request

curl https://covid-india-cases.herokuapp.com/statetimeline/

Example response

[
    {
        "2020-01-30": 0,
        "2020-01-31": 0,
        "2020-02-01": 0,
        "2020-02-02": 0,
        "2020-02-03": 0,
        "2020-02-04": 0,
        "2020-02-05": 0,
        .
        .
        .
        "2020-08-03": 734,
        "2020-08-04": 830,
        "2020-08-05": 928,
        "2020-08-06": 1027,
        "2020-08-07": 1123,
        "2020-08-08": 1222,
        "2020-08-09": 1351,
        "2020-08-10": 1490,
        "2020-08-11": 1625,
        "2020-08-12": 1764,
        "2020-08-13": 1900,
        "2020-08-14": 2037,
        "2020-08-15": 2186,
        "2020-08-16": 2306,
        "State UT": "Andaman and Nicobar Islands"
    },
    ...
]

Active cases timeline

Lists the total number of active cases statewise with respect to time. The response is an array of JSON where each element has multiple dates in the form of YYYY-MM-DD and the last key State UT as the name of the State/UT. The API returns data from 30th January till today

GET
https://covid-india-cases.herokuapp.com/activetimeline/

Example request

curl https://covid-india-cases.herokuapp.com/activetimeline/

Example response

[
    {
        "2020-01-30": 0,
        "2020-01-31": 0,
        "2020-02-01": 0,
        "2020-02-02": 0,
        "2020-02-03": 0,
        "2020-02-04": 0,
        "2020-02-05": 0,
        .
        .
        .
        "2020-08-03": 484,
        "2020-08-04": 557,
        "2020-08-05": 639,
        "2020-08-06": 687,
        "2020-08-07": 752,
        "2020-08-08": 778,
        "2020-08-09": 831,
        "2020-08-10": 822,
        "2020-08-11": 896,
        "2020-08-12": 994,
        "2020-08-13": 1050,
        "2020-08-14": 1091,
        "2020-08-15": 1130,
        "2020-08-16": 1154,
        "State UT": "Andaman and Nicobar Islands"
    },
    ...
]

Cured cases timeline

Lists the total number of cured cases statewise with respect to time. The response is an array of JSON where each element has multiple dates in the form of YYYY-MM-DD and the last key State UT as the name of the State/UT. The API returns data from 30th January till today

GET
https://covid-india-cases.herokuapp.com/curedtimeline/

Example request

curl https://covid-india-cases.herokuapp.com/curedtimeline/

Example response

[
    {
        "2020-01-30": 0,
        "2020-01-31": 0,
        "2020-02-01": 0,
        "2020-02-02": 0,
        "2020-02-03": 0,
        "2020-02-04": 0,
        "2020-02-05": 0,
        .
        .
        .
        "2020-08-03": 242,
        "2020-08-04": 263,
        "2020-08-05": 277,
        "2020-08-06": 326,
        "2020-08-07": 355,
        "2020-08-08": 425,
        "2020-08-09": 500,
        "2020-08-10": 648,
        "2020-08-11": 709,
        "2020-08-12": 749,
        "2020-08-13": 829,
        "2020-08-14": 924,
        "2020-08-15": 1032,
        "2020-08-16": 1128,
        "State UT": "Andaman and Nicobar Islands"
    },
    ...
]

Death cases timeline

Lists the total number of death cases statewise with respect to time. The response is an array of JSON where each element has multiple dates in the form of YYYY-MM-DD and the last key State UT as the name of the State/UT. The API returns data from 30th January till today

GET
https://covid-india-cases.herokuapp.com/deathtimeline/

Example request

curl https://covid-india-cases.herokuapp.com/deathtimeline/

Example response

[
    {
        "2020-01-30": 0,
        "2020-01-31": 0,
        "2020-02-01": 0,
        "2020-02-02": 0,
        "2020-02-03": 0,
        "2020-02-04": 0,
        "2020-02-05": 0,
        .
        .
        .
        "2020-08-03": 8,
        "2020-08-04": 10,
        "2020-08-05": 12,
        "2020-08-06": 14,
        "2020-08-07": 16,
        "2020-08-08": 19,
        "2020-08-09": 20,
        "2020-08-10": 20,
        "2020-08-11": 20,
        "2020-08-12": 21,
        "2020-08-13": 21,
        "2020-08-14": 22,
        "2020-08-15": 24,
        "2020-08-16": 24,
        "State UT": "Andaman and Nicobar Islands"
    },
    ...
]
Show examples in:

Covid 19 India API Docs