GET countries

disease.sh:covid-19-api-disease.sh

Summary: Get COVID-19 statistics for all countries
Operation ID: getAllCountries
Auth: none

Returns an array of COVID-19 statistics for every country in the world. Each country object includes the same metrics as the global /all endpoint (cases, deaths, recovered, tests, etc.) plus country-specific metadata like ISO codes, population, and flag URLs. This is the primary endpoint for building country comparison dashboards or populating maps. Unlike /countries/{country} which returns a single country, this returns all ~230 countries at once. Use the `sort` parameter to order results by a specific metric like cases or deaths.

Original spec description

Returns an array of COVID-19 data for all countries.

Usage Tips

- Use `sort=cases` or `sort=deaths` to get countries ranked by impact - The response is large (~130KB) - consider caching if calling frequently - Each country includes a `countryInfo` object with ISO2/ISO3 codes and flag URLs - Combine with `yesterday=true` to get day-over-day change data for all countries - The `allowNull` parameter controls whether null values are included in the response

Parameters (4)

allowNull (string, query, optional)

Allow null values in response

Constraints: {'enum': ['true', 'false']}

sort (string, query, optional)

Sort results by a specific field

Constraints: {'enum': ['cases', 'deaths', 'recovered', 'active', 'critical', 'tests', 'population']}

twoDaysAgo (string, query, optional)

Include data from two days ago

Constraints: {'enum': ['true', 'false', '1', '0']}

yesterday (string, query, optional)

Include yesterday's data

Constraints: {'enum': ['true', 'false', '1', '0']}

Examples (3)

TitleTypeURLAction
Get all countries with default sorting curl https://disease.sh/v3/covid-19/countries
Get countries sorted by total cases curl https://disease.sh/v3/covid-19/countries?sort=cases
Get yesterday's data sorted by deaths curl https://disease.sh/v3/covid-19/countries?sort=deaths&yesterday=true

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-03-23 10:32:21.656334 200 119ms
2026-03-23 10:08:52.497276 200 152ms
2026-03-23 09:40:17.824065 200 116ms

Response Changes

WhenOldNew
2026-03-23 10:08:52.497276 6b5943f60eb0 f1c221f4d9c3
2026-03-23 10:32:21.656334 f1c221f4d9c3 566f87d0a4d2