v5

latestOpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB
Health

Top-N country ranking for a WHO GHO indicator and year

Rank countries by a World Health Organization Global Health Observatory (WHO GHO) indicator for a chosen calendar year. Only rows with SpatialDimType=COUNTRY and Dim1=SEX_BTSX (both sexes) are considered so the leaderboard is comparable across countries. Use order=desc (default) for largest values first (e.g. countries with the highest life expectancy) or order=asc for lowest values first (e.g. lowest under-5 mortality).

get/api/v1/health/who/rankings/{code}

Path parameters

codestring required

Indicator code (e.g. WHOSIS_000001 for life expectancy, MDG_0000000007 for under-5 mortality).

Indicator code (e.g. WHOSIS_000001 for life expectancy, MDG_0000000007 for under-5 mortality).

Query parameters

yearinteger required

Calendar year of the ranking (required).

Calendar year of the ranking (required).

limitinteger

Maximum entries to return (1 to 50).

Maximum entries to return (1 to 50).

orderstring

Sort direction - desc for highest values first, asc for lowest.

Sort direction - desc for highest values first, asc for lowest.

Response

Ranked country entries with rank, code, WHO region, year, numeric value, and display string.

Example response

{
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ]
  }
}