Name: World Happiness Report
Creator: World Happiness Report
License: https://www.worldhappiness.report/data-sharing/

Redistributable. This source is served as canonical Parquet under the license below, with attribution and provenance preserved.

Coverage

Series catalogued

1,749

Temporal coverage

2011-12-31 – 2025-12-31

Frequencies

Annual

Distinct geographies

168

Licensing & provenance

License: World Happiness Report (written permission, Figure 2.1 scope)
License URL: https://www.worldhappiness.report/data-sharing/
Required attribution: Source: World Happiness Report (Wellbeing Research Centre, University of Oxford), powered by the Gallup World Poll. Redistributed under written permission; non-commercial use only.
Redistribution: Permitted (served here)
Commercial use: Restricted / no
Modification: Permitted
Provider homepage: https://www.worldhappiness.report/
Provider terms: https://www.worldhappiness.report/data-sharing/

How to cite

World Happiness Report, published by the Wellbeing Research Centre at the University of Oxford in partnership with Gallup and the UN Sustainable Development Solutions Network. Data powered by the Gallup World Poll. Redistributed by the Elkassabgi Data Library under written permission granted 2026-07-09; non-commercial use, attribution required.

Processing: Retrieved from the World Happiness Report's published data, normalized to a long {series_key, obs_date, value} schema and stored as zstd Parquet.

Access & mirrors

Download: Select & download whr series as CSV →
API: Get a free API key, then GET /v1/series/<id>.csv
Canonical landing: https://econdatalibrary.com/whr
Update cadence: annual
Automated refresh: live — this database is on the daily update run
Update strategy: overwrite if changed
Storage layout: single parquet: data/clean_full/whr/whr.parquet (~13 KB; series_key/obs_date/value). Multiple side-car log/err files (_whr_log*.txt, _whr_err*.txt).

Structured metadata

schema.org/Dataset (Google Dataset Search)

{
  "@context": "https://schema.org/",
  "@type": "Dataset",
  "name": "World Happiness Report",
  "description": "World Happiness Report — self-reported life satisfaction (Figure 2.1 scope). 1,749 series, 2011–2025. Free download under World Happiness Report.",
  "url": "https://econdatalibrary.com/whr",
  "identifier": "whr",
  "isAccessibleForFree": true,
  "publisher": {
    "@type": "Organization",
    "name": "Econ Data Library",
    "url": "https://econdatalibrary.com"
  },
  "includedInDataCatalog": {
    "@type": "DataCatalog",
    "@id": "https://econdatalibrary.com/#catalog",
    "name": "Econ Data Library",
    "url": "https://econdatalibrary.com/catalog"
  },
  "creator": {
    "@type": "Organization",
    "name": "World Happiness Report",
    "url": "https://www.worldhappiness.report/"
  },
  "license": "https://www.worldhappiness.report/data-sharing/",
  "keywords": [
    "Society & Well-Being",
    "Wellbeing",
    "whr"
  ],
  "variableMeasured": [
    "Contribution of perceptions of corruption",
    "Dystopia + residual",
    "Contribution of freedom to make life choices",
    "Contribution of log GDP per capita",
    "Contribution of generosity",
    "Contribution of healthy life expectancy",
    "Life evaluation, 3-year average (Cantril ladder)",
    "Happiness ranking (Figure 2.1)",
    "Contribution of social support",
    "Life evaluation, 95% CI upper bound",
    "Life evaluation, 95% CI lower bound"
  ],
  "temporalCoverage": "2011-12-31/2025-12-31",
  "repeatFrequency": "P1Y",
  "creditText": "Source: World Happiness Report (Wellbeing Research Centre, University of Oxford), powered by the Gallup World Poll. Redistributed under written permission; non-commercial use only.",
  "citation": "World Happiness Report, published by the Wellbeing Research Centre at the University of Oxford in partnership with Gallup and the UN Sustainable Development Solutions Network. Data powered by the Gallup World Poll. Redistributed by the Elkassabgi Data Library under written permission granted 2026-07-09; non-commercial use, attribution required.",
  "sameAs": [
    "https://huggingface.co/datasets/econdatalibrary-whr",
    "https://zenodo.org/communities/econdatalibrary"
  ],
  "distribution": [
    {
      "@type": "DataDownload",
      "name": "whr — CSV",
      "encodingFormat": "text/csv",
      "contentUrl": "https://econdatalibrary.com/download.html?source=whr",
      "license": "https://www.worldhappiness.report/data-sharing/"
    }
  ]
}

Croissant (ML-ready, schema.org JSON-LD)

{
  "@context": {
    "@language": "en",
    "@vocab": "https://schema.org/",
    "cr": "http://mlcommons.org/croissant/",
    "data": {
      "@id": "cr:data",
      "@type": "@json"
    },
    "dataType": {
      "@id": "cr:dataType",
      "@type": "@vocab"
    },
    "sc": "https://schema.org/",
    "conformsTo": "dct:conformsTo",
    "dct": "http://purl.org/dc/terms/"
  },
  "@type": "sc:Dataset",
  "conformsTo": "http://mlcommons.org/croissant/1.0",
  "name": "whr",
  "description": "World Happiness Report — self-reported life satisfaction (Figure 2.1 scope). 1,749 series, 2011–2025. Free download under World Happiness Report.",
  "url": "https://econdatalibrary.com/whr",
  "creator": {
    "@type": "sc:Organization",
    "name": "World Happiness Report",
    "url": "https://www.worldhappiness.report/"
  },
  "publisher": {
    "@type": "sc:Organization",
    "name": "Econ Data Library",
    "url": "https://econdatalibrary.com"
  },
  "license": "https://www.worldhappiness.report/data-sharing/",
  "keywords": [
    "Society & Well-Being",
    "Wellbeing"
  ],
  "temporalCoverage": "2011-12-31/2025-12-31",
  "citation": "World Happiness Report, published by the Wellbeing Research Centre at the University of Oxford in partnership with Gallup and the UN Sustainable Development Solutions Network. Data powered by the Gallup World Poll. Redistributed by the Elkassabgi Data Library under written permission granted 2026-07-09; non-commercial use, attribution required.",
  "distribution": [
    {
      "@type": "cr:FileObject",
      "@id": "whr-csv",
      "name": "whr-csv",
      "description": "Per-series CSV, downloadable with a free API key.",
      "contentUrl": "https://econdatalibrary.com/download.html?source=whr",
      "encodingFormat": "text/csv"
    }
  ]
}