{
  "dataset_id": "world-electricity-use",
  "status": "source_candidate",
  "created_at": "2026-07-13",
  "updated_at": "2026-07-21",
  "definition": "annual total final consumption of electricity",
  "unit": "TWh/year",
  "source_method_note": "UNSD Energy Statistics Yearbook 2023, Table 34, Total final consumption (TFC), Electricity. World row: 25,539,798 GWh. United Kingdom row: 269,086 GWh. Australia row: 224,377 GWh. Canada row: 529,902 GWh. Japan row: 879,200 GWh. Official GWh values are divided by 1,000 to obtain TWh/year.",
  "records": [
    {
      "code": "WLD",
      "name": "World",
      "local_name": "World",
      "sentence_name": "the world",
      "local_language": "en",
      "local_language_label": "English",
      "jurisdiction_type": "global",
      "parent": null,
      "population": null,
      "annual_electricity_twh": 25539.798,
      "electricity_per_capita_kwh_year": null,
      "source_name": "United Nations Statistics Division (UNSD)",
      "source_dataset": "2023 Energy Statistics Yearbook",
      "source_series": "Table 34: Total final consumption (TFC) — Electricity — World",
      "source_url": "https://unstats.un.org/unsd/energystats/pubs/yearbook/2023/t34.pdf",
      "source_year": "2023",
      "source_retrieved_at": "2026-07-13",
      "source_status": "source_candidate",
      "definition": "annual total final consumption of electricity",
      "unit_original": "gigawatt-hour",
      "conversion_note": "Official UNSD Table 34 value of 25,539,798 GWh divided by 1,000 to obtain 25,539.798 TWh/year.",
      "review_flags": [
        "unsd_yearbook_table_value_checked",
        "source_candidate_not_promoted"
      ],
      "notes": "Official UNSD Yearbook table value checked for the World row. This is an annual final-electricity energy denominator for public review, not spare grid capacity, installed capacity, or promoted runtime data."
    },
    {
      "code": "UK",
      "name": "United Kingdom",
      "local_name": "United Kingdom",
      "sentence_name": "the United Kingdom",
      "local_language": "en",
      "local_language_label": "English",
      "jurisdiction_type": "country",
      "parent": null,
      "population": null,
      "annual_electricity_twh": 269.086,
      "electricity_per_capita_kwh_year": null,
      "source_name": "United Nations Statistics Division (UNSD)",
      "source_dataset": "2023 Energy Statistics Yearbook",
      "source_series": "Table 34: Total final consumption (TFC) — Electricity — United Kingdom",
      "source_url": "https://unstats.un.org/unsd/energystats/pubs/yearbook/2023/t34.pdf",
      "source_year": "2023",
      "source_retrieved_at": "2026-07-21",
      "source_status": "source_candidate",
      "definition": "annual total final consumption of electricity",
      "unit_original": "gigawatt-hour",
      "conversion_note": "Official UNSD Table 34 value of 269,086 GWh divided by 1,000 to obtain 269.086 TWh/year.",
      "review_flags": [
        "unsd_yearbook_table_value_checked",
        "selected_non_eu_country_denominator",
        "source_candidate_not_promoted"
      ],
      "notes": "Official UNSD Yearbook table value checked for the United Kingdom row. This is a selected non-EU country annual final-electricity denominator within World mode for public review, not spare grid capacity, installed capacity, or promoted runtime data."
    },
    {
      "code": "AU",
      "name": "Australia",
      "local_name": "Australia",
      "sentence_name": "Australia",
      "local_language": "en",
      "local_language_label": "English",
      "jurisdiction_type": "country",
      "parent": null,
      "population": null,
      "annual_electricity_twh": 224.377,
      "electricity_per_capita_kwh_year": null,
      "source_name": "United Nations Statistics Division (UNSD)",
      "source_dataset": "2023 Energy Statistics Yearbook",
      "source_series": "Table 34: Total final consumption (TFC) — Electricity — Australia",
      "source_url": "https://unstats.un.org/unsd/energystats/pubs/yearbook/2023/t34.pdf",
      "source_year": "2023",
      "source_retrieved_at": "2026-07-21",
      "source_status": "source_candidate",
      "definition": "annual total final consumption of electricity",
      "unit_original": "gigawatt-hour",
      "conversion_note": "Official UNSD Table 34 value of 224,377 GWh divided by 1,000 to obtain 224.377 TWh/year.",
      "review_flags": [
        "unsd_yearbook_table_value_checked",
        "selected_non_eu_country_denominator",
        "source_candidate_not_promoted"
      ],
      "notes": "Official UNSD Yearbook table value checked for the Australia row. This is a selected non-EU country annual final-electricity denominator within World mode for public review, not spare grid capacity, installed capacity, or promoted runtime data."
    },
    {
      "code": "CA",
      "name": "Canada",
      "local_name": "Canada",
      "sentence_name": "Canada",
      "local_language": "en",
      "local_language_label": "English",
      "jurisdiction_type": "country",
      "parent": null,
      "population": null,
      "annual_electricity_twh": 529.902,
      "electricity_per_capita_kwh_year": null,
      "source_name": "United Nations Statistics Division (UNSD)",
      "source_dataset": "2023 Energy Statistics Yearbook",
      "source_series": "Table 34: Total final consumption (TFC) — Electricity — Canada",
      "source_url": "https://unstats.un.org/unsd/energystats/pubs/yearbook/2023/t34.pdf",
      "source_year": "2023",
      "source_retrieved_at": "2026-07-21",
      "source_status": "source_candidate",
      "definition": "annual total final consumption of electricity",
      "unit_original": "gigawatt-hour",
      "conversion_note": "Official UNSD Table 34 value of 529,902 GWh divided by 1,000 to obtain 529.902 TWh/year.",
      "review_flags": [
        "unsd_yearbook_table_value_checked",
        "selected_non_eu_country_denominator",
        "source_candidate_not_promoted"
      ],
      "notes": "Official UNSD Yearbook table value checked for the Canada row. This is a selected non-EU country annual final-electricity denominator within World mode for public review, not spare grid capacity, installed capacity, or promoted runtime data."
    },
    {
      "code": "JP",
      "name": "Japan",
      "local_name": "日本",
      "local_language": "ja",
      "local_language_label": "Japanese",
      "jurisdiction_type": "country",
      "parent": null,
      "population": null,
      "annual_electricity_twh": 879.2,
      "electricity_per_capita_kwh_year": null,
      "source_name": "United Nations Statistics Division (UNSD)",
      "source_dataset": "2023 Energy Statistics Yearbook",
      "source_series": "Table 34: Total final consumption (TFC) — Electricity — Japan",
      "source_url": "https://unstats.un.org/unsd/energystats/pubs/yearbook/2023/t34.pdf",
      "source_year": "2023",
      "source_retrieved_at": "2026-07-21",
      "source_status": "source_candidate",
      "definition": "annual total final consumption of electricity",
      "unit_original": "gigawatt-hour",
      "conversion_note": "Official UNSD Table 34 value of 879,200 GWh divided by 1,000 to obtain 879.200 TWh/year.",
      "review_flags": [
        "unsd_yearbook_table_value_checked",
        "selected_non_eu_country_denominator",
        "source_candidate_not_promoted"
      ],
      "notes": "Official UNSD Yearbook table value checked for the Japan row. This is a selected non-EU country annual final-electricity denominator within World mode for public review, not spare grid capacity, installed capacity, or promoted runtime data."
    }
  ],
  "metric_scope": "UNSD annual total final consumption (TFC) of electricity for the World and selected non-EU country denominators",
  "comparability_note": "These are annual final consumption of electricity values. They are energy denominators, not available power or grid capacity. World is the global total; selected country rows are separate country denominators, not subdivisions of the global total display.",
  "rounding_precision_twh": 0.001,
  "source_provenance": {
    "official_source_system": "United Nations Statistics Division (UNSD)",
    "publication": "2023 Energy Statistics Yearbook",
    "table": "Table 34: Total final consumption",
    "direct_table_url": "https://unstats.un.org/unsd/energystats/pubs/yearbook/2023/t34.pdf",
    "landing_page": "https://unstats.un.org/unsd/energy/yearbook/default.htm",
    "rows": [
      {
        "code": "WLD",
        "row": "World",
        "official_gwh": 25539798,
        "candidate_twh": 25539.798
      },
      {
        "code": "UK",
        "row": "United Kingdom",
        "official_gwh": 269086,
        "candidate_twh": 269.086
      },
      {
        "code": "AU",
        "row": "Australia",
        "official_gwh": 224377,
        "candidate_twh": 224.377
      },
      {
        "code": "CA",
        "row": "Canada",
        "official_gwh": 529902,
        "candidate_twh": 529.902
      },
      {
        "code": "JP",
        "row": "Japan",
        "official_gwh": 879200,
        "candidate_twh": 879.2
      }
    ],
    "product": "Electricity",
    "flow": "Total final consumption (TFC)",
    "source_unit": "GWh",
    "period": "2023"
  }
}
