Version 1

Endpoints

get
Get Global Totals

https://corona.lmao.ninja/all
Get global stats: cases, deaths, recovered, time last updated, and active cases
Request
Response
Request
Response
200: OK
{
"cases": 662967,
"deaths": 30850,
"recovered": 141953,
"updated": 1585442840490,
"active": 490164
}

get
Get US State Totals

https://corona.lmao.ninja/states
Get stats on United States of America States with COVID-19, including cases, new cases, deaths, new deaths, and active cases
Request
Response
Request
Response
200: OK
[
{
"state": "New York",
"cases": 53393,
"todayCases": 7131,
"deaths": 883,
"todayDeaths": 277,
"active": 49784
},
{
"state": "New Jersey",
"cases": 11124,
"todayCases": 2299,
"deaths": 140,
"todayDeaths": 32,
"active": 10984
},
... other states
]

Country Endpoints

get
Get All Countries Totals

https://corona.lmao.ninja/countries
Returns a JSON array with an element for each country that has stats available. This includes iso codes, lat/long, a link to the country flag, cases, new cases, deaths, new deaths, recovered, active cases, critical cases, and cases/deaths per one million people.
Request
Response
Request
Response
200: OK
[
{
"country": "USA",
"countryInfo": {
"_id": 840,
"country": "USA",
"iso2": "US",
"iso3": "USA",
"lat": 38,
"long": -97,
"flag": "https://raw.githubusercontent.com/NovelCOVID/API/master/assets/flags/us.png"
},
"cases": 123428,
"todayCases": 19302,
"deaths": 2211,
"todayDeaths": 515,
"recovered": 3231,
"active": 117986,
"critical": 2666,
"casesPerOneMillion": 373,
"deathsPerOneMillion": 7
},
... more items
]

get
Get a Specific Country's Totals

https://corona.lmao.ninja/countries/:countryName
Get the same data from the /countries endpoint, but filter down to a specific country.
Request
Response
Request
Path Parameters
countryName
optional
string
Response
200: OK
{
"country": "USA",
"countryInfo": {
"_id": 840,
"country": "USA",
"iso2": "US",
"iso3": "USA",
"lat": 38,
"long": -97,
"flag": "https://raw.githubusercontent.com/NovelCOVID/API/master/assets/flags/us.png"
},
"cases": 123428,
"todayCases": 19302,
"deaths": 2211,
"todayDeaths": 515,
"recovered": 3231,
"active": 117986,
"critical": 2666,
"casesPerOneMillion": 373,
"deathsPerOneMillion": 7
}

get
Get Specific Country Totals by ID

https://corona.lmao.ninja/countries/:countryId
Get country data by ID
Request
Response
Request
Path Parameters
countryId
optional
string
Response
200: OK
{
"country": "USA",
"countryInfo": {
"_id": 840,
"country": "USA",
"iso2": "US",
"iso3": "USA",
"lat": 38,
"long": -97,
"flag": "https://raw.githubusercontent.com/NovelCOVID/API/master/assets/flags/us.png"
},
"cases": 123428,
"todayCases": 19302,
"deaths": 2211,
"todayDeaths": 515,
"recovered": 3231,
"active": 117986,
"critical": 2666,
"casesPerOneMillion": 373,
"deathsPerOneMillion": 7
}

get
Get Country by ISO2

https://corona.lmao.ninja/countries/:iso2
Get a country by it's ISO2, like "US"
Request
Response
Request
Path Parameters
iso2
optional
string
Response
200: OK
{
"country": "USA",
"countryInfo": {
"_id": 840,
"country": "USA",
"iso2": "US",
"iso3": "USA",
"lat": 38,
"long": -97,
"flag": "https://raw.githubusercontent.com/NovelCOVID/API/master/assets/flags/us.png"
},
"cases": 123428,
"todayCases": 19302,
"deaths": 2211,
"todayDeaths": 515,
"recovered": 3231,
"active": 117986,
"critical": 2666,
"casesPerOneMillion": 373,
"deathsPerOneMillion": 7
}

get
Get Country By ISO3

https://corona.lmao.ninja/countries/:iso3
Get a country by it's ISO3 like "USA"
Request
Response
Request
Response
200: OK
{
"country": "USA",
"countryInfo": {
"_id": 840,
"country": "USA",
"iso2": "US",
"iso3": "USA",
"lat": 38,
"long": -97,
"flag": "https://raw.githubusercontent.com/NovelCOVID/API/master/assets/flags/us.png"
},
"cases": 123428,
"todayCases": 19302,
"deaths": 2211,
"todayDeaths": 515,
"recovered": 3231,
"active": 117986,
"critical": 2666,
"casesPerOneMillion": 373,
"deathsPerOneMillion": 7
}

get
Sort All Countries

https://corona.lmao.ninja/countries?sort={parameter}
Sort the response from /countries by, cases, todaycases, deaths, todayDeaths, etc
Request
Response
Request
Query Parameters
sort
optional
string
cases, todayCases, deaths, todayDeaths, recovered, active, critical, casesPerOneMillion, deathsPerOneMillion
Response
200: OK

JHU CSSE Data Endpoints (DEPRECATED)

(JHU CSSE is data coming from Johns Hopkins University)

get
Get All JHU CSSE

https://corona.lmao.ninja/jhucsse
THIS IS A DEPRECATED METHOD, PLEASE USE V2 METHODS!Get data from JHU CSSE
Request
Response
Request
Response
200: OK
[
{
"country": "US",
"province": "South Carolina",
"city": "Abbeville",
"updatedAt": "2020-03-28 23:05:37",
"stats": {
"confirmed": "3",
"deaths": "0",
"recovered": "0"
},
"coordinates": {
"latitude": "34.22333378",
"longitude": "-82.46170658"
}
},
... more objects
]

get
Get Historical Data

https://corona.lmao.ninja/historical
Get Timeseries info from JHU CSSE
Request
Response
Request
Response
200: OK
{
"message": "Deprecated, use /v2/historical"
}