API Documentation

Obtain Official COVID-19 stats in Real-Time.

We are also on Postman API Documentation Page.
api.covid.sh
🏠 https://covid.sh  ⚡ api.covid.sh offers COVID-19 data up to the lowest geographic classification of a country i.e. county/taluk/sub-district/district, Real-Time, Period.  ⚒️ We've built this for a developer from the ground up and hope amazing, impactful applications will be built on our free api.  🌐 We run a global edge optimized AWS Infrastructure with API latency of 100ms.  ❓Who Built This?  Suhail CS (Grade 12 + https://en.wikipedia.org/wiki/Mo...) &amp; Pranav Shikarpur( UMD Freshman + https://snpranav.com) &amp; Team An Amazing Team.  💰 Project Supported By Emergent Ventures of Mercatus Center (https://www.mercatus.org/)  [+] Available for select countries only; refer: https://docs.covid.sh/endpoints/...
documenter.getpostman.com
Visit Us On Postman
v1 Available For Production
Endpoint URL
https://api.covid.sh/v1/
get
Get global stats
https://api.covid.sh/v1/global
Request
Response
Request
Path Parameters
global
required
string
pass the string "global"
Response
200: OK
{
    "datetime": "2020-04-27T17:49:40Z",
    "area": "Gobal",
    "cases": "3002303",
    "deaths": "208131",
    "recovered": "878813",
    "sources": "https://en.wikipedia.org/wiki/2019%E2%80%9320_coronavirus_pandemic"
}
get
Get list of all available countries
https://api.covid.sh/v1/available
Request
Response
Request
Path Parameters
available
required
string
pass the string "available"
Response
200: OK
{
    "Bosnia & Herzegovina": {
        "url_endpoint": "https://api.covid.sh/v1/ba"
    },
    "Barbados": {
        "url_endpoint": "https://api.covid.sh/v1/bb"
    },
    "Serbia": {
        "url_endpoint": "https://api.covid.sh/v1/rs"
    },
    "Bangladesh": {
        "url_endpoint": "https://api.covid.sh/v1/bd"
    },
    "Russia": {
        "url_endpoint": "https://api.covid.sh/v1/ru"
    }, ...
    ...
    ...
    ...
}
get
Get country stats
https://api.covid.sh/v1/<country>
Request
Response
Request
Path Parameters
<country>
required
string
Provide Country Code in ISO 3166 Alpha-2.
Response
200: OK
{
    "country_name": "India",
    "cases": 28380,
    "recovery": 6362,
    "deaths": 886,
    "sources": "https://en.wikipedia.org/wiki/2019%E2%80%9320_coronavirus_pandemic",
    "datetime": "2020-04-27T17:49:23Z"
}
Unaware of ISO 3166 Alpha-2 codes? Use our available endpoints to get the desired location endpoints.
get
Get list of all available regions for a country
https://api.covid.sh/v1/<country>/available
Request
Response
Request
Path Parameters
available
required
string
pass the string "available".
<country>
required
Provide Country Code in ISO 3166 Alpha-2 
Response
200: OK
{
    "Delaware": {
        "url_endpoint": "https://api.covid.sh/v1/us/de"
    },
    "Hawaii": {
        "url_endpoint": "https://api.covid.sh/v1/us/hi"
    },
    "Republic of Marshall Islands": {
        "url_endpoint": "https://api.covid.sh/v1/us/pr"
    },
    "Texas": {
        "url_endpoint": "https://api.covid.sh/v1/us/tx"
    },
    "Massachusetts": {
        "url_endpoint": "https://api.covid.sh/v1/us/ma"
    },
    "Maryland": {
        "url_endpoint": "https://api.covid.sh/v1/us/md"
    },
    ...
    ...
    ...
}
get
Get region stats
https://api.covid.sh/v1/<country>/<region>
Provides Region Data of A Country
Request
Response
Request
Path Parameters
<region>
required
string
Provide Region Code in ISO 3166 Alpha-2 
<country>
required
string
Provide Country Code in ISO 3166 Alpha-2
Response
200: OK
{
    "region_name": "Maharashtra",
    "cases": 8068,
    "recovery": 1188,
    "active_cases": 6538,
    "deaths": 342,
    "sources": "https://www.mohfw.gov.in/",
    "datetime": "2020-04-27T17:49:33Z"
}
All timestamps presented in our API responses are in UTC format.

Getting Started

Next - Endpoints

Sources

Last updated 3 months ago

API Documentation

getGet global stats

getGet list of all available countries

getGet country stats

getGet list of all available regions for a country

getGet region stats

get
Get global stats

get
Get list of all available countries

get
Get country stats

get
Get list of all available regions for a country

get
Get region stats