API Documentation

Obtain Official COVID-19 stats in Real-Time.

We are also on Postman API Documentation Page.

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.