{
  "schema": "qz.energy.data-lab/v1",
  "product_id": "qz-energy",
  "release_id": "qz-energy-science-5ce3d74e-20260829T082900Z",
  "generated_at": "2026-08-29T08:28:46Z",
  "policy": {
    "read_only": true,
    "static_release": true,
    "max_query_limit": 1000,
    "notes": {
      "ru": "Запросы выполняются только на чтение. JSON-stat 2.0 доступен для energy-indicators; Parquet остаётся полным versioned snapshot, а не динамическим форматом query endpoint.",
      "kk": "Сұраулар тек оқуға арналған. JSON-stat 2.0 energy-indicators үшін қолжетімді; толық өзгермейтін Parquet snapshot бар, ал query endpoint динамикалық формат ретінде қолданылмайды.",
      "en": "Requests are read-only. JSON-stat 2.0 is available for energy-indicators; Parquet remains a full versioned snapshot, not a dynamic query format."
    }
  },
  "summary": {
    "datasets": 38,
    "formats": [
      "json",
      "csv",
      "json-stat",
      "parquet"
    ],
    "filter_fields": [
      "period",
      "region",
      "object_type",
      "source_id",
      "status",
      "domain",
      "unit"
    ]
  },
  "datasets": [
    {
      "dataset_id": "energy-indicators",
      "path": "energy-indicators.json",
      "format": "json",
      "records": 173,
      "domain": "өндіру",
      "period_coverage": "2022-2026",
      "hash": "sha256:7f067fd37f9a688bcb4afe54bcde16858831150215c87ba8b2ab828a3887da69",
      "source": "ҚР Энергетика министрлігі, ҰСБ, Samruk-Energy, KEGOC, KOREM және QazaqGaz"
    },
    {
      "dataset_id": "electricity-generation-series",
      "path": "electricity-generation-series.json",
      "format": "json",
      "records": 6,
      "domain": "electricity",
      "period_coverage": "2020-2025",
      "hash": "sha256:63a0f6a164aa7f73b51692eac556aa50ceb9bbb48b34f8375314613ad0a112d7",
      "source": "KEGOC, годовой отчёт 2024 – баланс электр энергиясының; официальный шығарылым об итогах 2025 года"
    },
    {
      "dataset_id": "kegoc-balancing-series",
      "path": "kegoc-balancing-series.json",
      "format": "json",
      "records": 5,
      "domain": "electricity",
      "period_coverage": "2020-2024",
      "hash": "sha256:ac12a8d946b36b6279e58263d187ea6df1a4320f6d52beadd57cb383ad987970",
      "source": "KEGOC, 2024 жылғы жылдық есеп – өндірістік қызмет, 28-бет"
    },
    {
      "dataset_id": "kegoc-technical-dispatching-series",
      "path": "kegoc-technical-dispatching-series.json",
      "format": "json",
      "records": 5,
      "domain": "electricity",
      "period_coverage": "2020-2024",
      "hash": "sha256:881dc8720f47c018c0942eb049e7af678dbd9f1fcd2d4525185dd88f77012a82",
      "source": "KEGOC, 2024 жылғы жылдық есеп – өндірістік қызмет, 27-бет"
    },
    {
      "dataset_id": "public-energy-map",
      "path": "public-energy-map.geojson",
      "format": "geojson",
      "records": null,
      "domain": "инфрақұрылым",
      "period_coverage": "текущий жария шығарылым",
      "hash": "sha256:f1244624e91a5636fba47b7c2a280eac882766b74490fa353b04972ecf0cdbb0",
      "source": "KEGOC, KazTransOil, ҚР Энергетика министрлігі, Samruk-Energy және QazaqGaz"
    },
    {
      "dataset_id": "energy-map-view",
      "path": "energy-map-view.json",
      "format": "json",
      "records": null,
      "domain": "картография",
      "period_coverage": "текущий жария шығарылым",
      "hash": "sha256:5ef61abfdc3693ab04c5c811dd59bdd9d5a23a7e26c01372284671b6aa5678ee",
      "source": "qz.energy тексерілген жария жазбалары"
    },
    {
      "dataset_id": "source-allowlist",
      "path": "source-allowlist.json",
      "format": "json",
      "records": null,
      "domain": "дереккөздер",
      "period_coverage": "қазіргі дереккөз қағидалары",
      "hash": "sha256:9a468d9ea6e5e8a0163e3dbc55a0342345ac6521b8339b818beae77989d141e6",
      "source": "редакция qz.energy"
    },
    {
      "dataset_id": "freshness-register",
      "path": "freshness-register.json",
      "format": "json",
      "records": null,
      "domain": "дереккөздер",
      "period_coverage": "текущий жария шығарылым",
      "hash": "sha256:d1a83d014b8dfd8df210ce0686f059d33d5b52f41d2cb2255cdd8e2c90d15089",
      "source": "контроль шығарылымның qz.energy"
    },
    {
      "dataset_id": "map-layer-completeness",
      "path": "map-layer-completeness.json",
      "format": "json",
      "records": null,
      "domain": "картография",
      "period_coverage": "текущий жария шығарылым",
      "hash": "sha256:de409c6cf226fbf71f95e51a31ee536f15215d57a2e1f8b807d93ef7162be064",
      "source": "qz.energy тексерілген жария жазбалары"
    },
    {
      "dataset_id": "object-passports",
      "path": "object-passports.json",
      "format": "json",
      "records": null,
      "domain": "инфрақұрылым",
      "period_coverage": "текущий жария шығарылым",
      "hash": "sha256:9b499636c2ae5fb25aa81b6e840cf7345d99100124008468ad124e973319ffdd",
      "source": "KEGOC, KazTransOil, ҚР Энергетика министрлігі, Samruk-Energy және QazaqGaz"
    },
    {
      "dataset_id": "public-snapshot",
      "path": "qz-energy-public-snapshot.json",
      "format": "json",
      "records": null,
      "domain": "шығарылым",
      "period_coverage": "жария шығарылым qz-energy-card-context-addc4d5a-20260815T173531Z",
      "hash": "sha256:b894b381a61c7b0bdf24044ac82aa4753e3cb30ebd06ec7a4dece27396614942",
      "source": "qz.energy тексерілген жария көрінісі"
    },
    {
      "dataset_id": "qaz-events-energy-calendar",
      "path": "qaz-events-energy-calendar.json",
      "format": "json",
      "records": 11,
      "domain": "calendar",
      "period_coverage": "2026",
      "hash": "sha256:85d8bcd96911c11c067973eac46af826f48b2855709c023f1bb07a2111099196",
      "source": "Qaz.Events и перводереккөз каждой записи"
    },
    {
      "dataset_id": "global-benchmark",
      "path": "global-benchmark.json",
      "format": "json",
      "records": null,
      "domain": "даму жоспары",
      "period_coverage": "2026-07-28",
      "hash": "sha256:e71750d6364b18557d2b41d43053072affda3cbf54c0a40a114757cc213168c5",
      "source": "Global Energy Monitor, IEA, Ember, Electricity Maps, ENTSO-E, EIA, Open Infrastructure Map, Grid Status"
    },
    {
      "dataset_id": "infrastructure-contract",
      "path": "infrastructure-contract.json",
      "format": "json",
      "records": null,
      "domain": "шығарылым",
      "period_coverage": "жария шығарылым v0.6.15-avds4-final4-20260806T072948Z",
      "hash": "sha256:a904d7a0f45754f377f784773d073a7e7bfcfab6e7ec81d06f1fafce477b1ac1",
      "source": "контроль шығарылымның qz.energy"
    },
    {
      "dataset_id": "domain-taxonomy",
      "path": "domain-taxonomy.json",
      "format": "json",
      "records": null,
      "domain": "шығарылым",
      "period_coverage": "жария шығарылым v0.6.15-avds4-final4-20260806T072948Z",
      "hash": "sha256:66399d988f37884a6bed1c6011acc8a641d9769bb8c77756e2d95053c5012e83",
      "source": "контроль шығарылымның qz.energy"
    },
    {
      "dataset_id": "entities",
      "path": "entities.json",
      "format": "json",
      "records": null,
      "domain": "білім графы",
      "period_coverage": "жария шығарылым v0.6.15-avds4-final4-20260806T072948Z",
      "hash": "sha256:be9c191f21c8e22065f07336907c82de6805b466e4cf2ebafa9b6ebaa837a58e",
      "source": "жария сводка qz.energy"
    },
    {
      "dataset_id": "entity-graph",
      "path": "entity-graph.json",
      "format": "json",
      "records": null,
      "domain": "білім графы",
      "period_coverage": "жария шығарылым v0.6.15-avds4-final4-20260806T072948Z",
      "hash": "sha256:59e5bfcfb88a0b8124077d265fbc9696528c6fb831c2af92a6565c62cfd54656",
      "source": "жария сводка qz.energy"
    },
    {
      "dataset_id": "facts",
      "path": "facts.ndjson",
      "format": "ndjson",
      "records": 228,
      "domain": "білім графы",
      "period_coverage": "жария шығарылым v0.6.15-avds4-final4-20260806T072948Z",
      "hash": "sha256:f673328fb9ab308b5d1d6df5b2893b094afa2b8c6db26a551b337346b428063f",
      "source": "жария сводка qz.energy"
    },
    {
      "dataset_id": "claims",
      "path": "claims.ndjson",
      "format": "ndjson",
      "records": 9,
      "domain": "білім графы",
      "period_coverage": "жария шығарылым v0.6.15-avds4-final4-20260806T072948Z",
      "hash": "sha256:a64d3635900bdb72ca626702efe908261e9180093839084ecfe7e4e334a7ba3d",
      "source": "жарияланым qz.energy и первичные документы"
    },
    {
      "dataset_id": "series-catalog",
      "path": "series-catalog.json",
      "format": "json",
      "records": null,
      "domain": "дереккөздер",
      "period_coverage": "1991–2026",
      "hash": "sha256:1d9483cc6e6e7384688e421bb38475fbe65e794074aa5d6352cd43a3c2f64160",
      "source": "проверенные публичные показатели, годовые ряды KEGOC, а также табличные, динамические и инфраструктурные ряды БНС"
    },
    {
      "dataset_id": "energy-balance-series",
      "path": "energy-balance-series.json",
      "format": "json",
      "records": null,
      "domain": "demand",
      "period_coverage": "2021–2024",
      "hash": "sha256:395a5182168645bd1bfb5e69c237da7fe590ce02cc089607663d35e4785148f9",
      "source": "Ұлттық статистика бюросы ҚР, XLSX топливно-энергетического баланса"
    },
    {
      "dataset_id": "bns-dynamic-series",
      "path": "bns-dynamic-series.json",
      "format": "json",
      "records": null,
      "domain": "demand",
      "period_coverage": "1991–2024",
      "hash": "sha256:5889a03343660ec7c9bb4f993977dc98d5f56f9e6e2b96b163856dca7818a738",
      "source": "ҚР Ұлттық статистика бюросы, отын-энергетикалық теңгерімнің динамикалық кестелері"
    },
    {
      "dataset_id": "bns-sector-infrastructure-series",
      "path": "bns-sector-infrastructure-series.json",
      "format": "json",
      "records": null,
      "domain": "инфрақұрылым",
      "period_coverage": "2014–2025",
      "hash": "sha256:e5804bafe1d0ff414c04c0d64933e01ac76c8defe3fab7989acc112477d30745",
      "source": "Ұлттық статистика бюросы ҚР, формы 1-ГАЗ и 6-ТП"
    },
    {
      "dataset_id": "observations",
      "path": "observations.ndjson",
      "format": "ndjson",
      "records": 481,
      "domain": "дереккөздер",
      "period_coverage": "1991–2026",
      "hash": "sha256:386b567125caded07d2a2aec3f95547b83fc4581c7dff467eb2ae4aaabc3c58c",
      "source": "проверенные публичные показатели, годовые ряды KEGOC, а также табличные, динамические и инфраструктурные ряды БНС"
    },
    {
      "dataset_id": "ui-contract",
      "path": "ui-contract.json",
      "format": "json",
      "records": null,
      "domain": "шығарылым",
      "period_coverage": "жария шығарылым v0.6.15-avds4-final4-20260806T072948Z",
      "hash": "sha256:fcb4502a4d9fe997b2e289b3abfcb381019f03bc22b125c7c3b72c4955e384fc",
      "source": "контроль шығарылымның qz.energy"
    },
    {
      "dataset_id": "intelligence-requirements",
      "path": "intelligence-requirements.json",
      "format": "json",
      "records": null,
      "domain": "product-coverage",
      "period_coverage": "жария шығарылым qz-energy-card-context-addc4d5a-20260815T173531Z",
      "hash": "sha256:b7abce43adff4fde6e2372645f57e773b115464c5761dfc08cf831075d79f24c",
      "source": "профессиональный gap-аудит qz.energy"
    },
    {
      "dataset_id": "source-expansion-register",
      "path": "source-expansion-register.json",
      "format": "json",
      "records": null,
      "domain": "дереккөздер",
      "period_coverage": "жария шығарылым qz-energy-card-context-addc4d5a-20260815T173531Z",
      "hash": "sha256:c5e2ebc451eaaaddc79d13629eedbccd43f82188c9cc4690b3ade5d51fe27122",
      "source": "официальные публичные дереккөзи и профессиональный gap-аудит qz.energy"
    },
    {
      "dataset_id": "system-monitor",
      "path": "system-monitor.json",
      "format": "json",
      "records": 28,
      "domain": "electricity",
      "period_coverage": "2024–2025 годы, по периоду каждого показателя",
      "hash": "sha256:ccdfe69d998f8bac2537c25f2a7087a96685d3f5b0406a4764472315c7524930",
      "source": "KEGOC"
    },
    {
      "dataset_id": "regional-profiles",
      "path": "regional-profiles.json",
      "format": "json",
      "records": 20,
      "domain": "regional-energy",
      "period_coverage": "жария шығарылым qz-energy-card-context-addc4d5a-20260815T173531Z",
      "hash": "sha256:a232e34d15e3a6f83a0b730e612eeedee00bb13e155cfdebaf4b0ab9a3c79e0b",
      "source": "БНС, KEGOC, KOREM, Samruk-Energy, QazaqGaz и первичные дереккөзи нысандардың"
    },
    {
      "dataset_id": "project-tracker",
      "path": "project-tracker.json",
      "format": "json",
      "records": 18,
      "domain": "инфрақұрылым",
      "period_coverage": "жария шығарылым qz-energy-card-context-addc4d5a-20260815T173531Z",
      "hash": "sha256:da38d6f72610effdd5eaf418703874cd518bf42e3dff6251fadc2b928e96fe82",
      "source": "первичные дереккөзи паспортов нысандардың qz.energy"
    },
    {
      "dataset_id": "market-tariff-centre",
      "path": "market-tariff-centre.json",
      "format": "json",
      "records": 36,
      "domain": "prices",
      "period_coverage": "2024–2025",
      "hash": "sha256:ed6a3f9f655b6d360d65ae0921f5e71df9d0445c15869d14bee9fc77a1a21f54",
      "source": "KOREM"
    },
    {
      "dataset_id": "investment-terminal",
      "path": "investment-terminal.json",
      "format": "json",
      "records": 6,
      "domain": "investment",
      "period_coverage": "жария шығарылым qz-energy-card-context-addc4d5a-20260815T173531Z",
      "hash": "sha256:c60b3b32aebadf57d484f3dac42cb0043c3b7c90d47e18714d9f6b83dc3b3386",
      "source": "первичные дереккөзи паспортов жоба и KOREM"
    },
    {
      "dataset_id": "geopolitical-dependencies",
      "path": "geopolitical-dependencies.json",
      "format": "json",
      "records": 4,
      "domain": "geopolitics",
      "period_coverage": "жария шығарылым qz-energy-card-context-addc4d5a-20260815T173531Z",
      "hash": "sha256:f7cb9e7425f4cd03176504784a2a8ef31fd95e51d697e9900f1c5b03fb54cb1b",
      "source": "первичные дереккөзи паспортов нысандардың qz.energy"
    },
    {
      "dataset_id": "climate-water-carbon",
      "path": "climate-water-carbon.json",
      "format": "json",
      "records": 10,
      "domain": "emissions",
      "period_coverage": "2024–2025",
      "hash": "sha256:3077f1721483efa34c9e74b493b33e31bf738cd23e8c2cb937657da57c4ed246",
      "source": "Энергетика министрлігі ҚР и Samruk-Energy"
    },
    {
      "dataset_id": "ownership-finance",
      "path": "ownership-finance.json",
      "format": "json",
      "records": 17,
      "domain": "investment",
      "period_coverage": "2024–2026",
      "hash": "sha256:8cf2bf35e69a032a509813db37790da2b17a2e093f52850feb09d86baffcae1d",
      "source": "Samruk-Energy и KazTransOil"
    },
    {
      "dataset_id": "scenario-lab",
      "path": "scenario-lab.json",
      "format": "json",
      "records": 9,
      "domain": "scenarios",
      "period_coverage": "2025–2050",
      "hash": "sha256:167dd853bbc928f3223a8d93e4396d97b80a5cbb02bf7684d46c0ee267609b75",
      "source": "Энергетика министрлігі ҚР и KEGOC для базы 2025 года"
    },
    {
      "dataset_id": "watch-centre",
      "path": "watch-centre.json",
      "format": "json",
      "records": 11,
      "domain": "workflow",
      "period_coverage": "жария шығарылым qz-energy-card-context-addc4d5a-20260815T173531Z",
      "hash": "sha256:6c30bffe58afbea6cbdf1c36e4d77fb8e0a88ce2563b06863f0ebe00ad95efde",
      "source": "тізілім жоба, рынков, дереккөзов и история шығарылымов qz.energy"
    },
    {
      "dataset_id": "editorial-intelligence",
      "path": "editorial-intelligence.json",
      "format": "json",
      "records": 9,
      "domain": "editorial",
      "period_coverage": "жария шығарылым qz-energy-card-context-addc4d5a-20260815T173531Z",
      "hash": "sha256:6dad956e2d476eed501539f079008c80ca2936eccf401e0c6384fee4f1a517fc",
      "source": "редакциялық журнал qz.energy и тексерілген тематический срез Qaz.Events"
    }
  ],
  "examples": [
    {
      "id": "json-filtered-page",
      "title": "JSON: фильтр и первая страница",
      "request": "https://qz.energy/api/v1/query?dataset_id=energy-indicators&domain=electricity&period=2025&limit=20&offset=0",
      "curl": "curl -fsS 'https://qz.energy/api/v1/query?dataset_id=energy-indicators&domain=electricity&period=2025&limit=20&offset=0'",
      "python": "import requests\nresponse = requests.get('https://qz.energy/api/v1/query', params={'dataset_id': 'energy-indicators', 'domain': 'electricity', 'period': '2025', 'limit': 20, 'offset': 0})\nresponse.raise_for_status()\ndata = response.json()",
      "javascript": "const response = await fetch('https://qz.energy/api/v1/query?dataset_id=energy-indicators&domain=electricity&period=2025&limit=20&offset=0');\nconst data = await response.json();"
    },
    {
      "id": "csv-export",
      "title": "CSV: выгрузка жиынтықа",
      "request": "https://qz.energy/api/v1/query?dataset_id=energy-indicators&format=csv&limit=1000",
      "curl": "curl -fL 'https://qz.energy/api/v1/query?dataset_id=energy-indicators&format=csv&limit=1000' -o energy-indicators.csv"
    },
    {
      "id": "json-stat-indicators",
      "title": "JSON-stat 2.0: показатели",
      "request": "https://qz.energy/api/v1/query?dataset_id=energy-indicators&format=json-stat&domain=electricity&limit=1000",
      "curl": "curl -fsS 'https://qz.energy/api/v1/query?dataset_id=energy-indicators&format=json-stat&domain=electricity&limit=1000' -o energy-indicators.json-stat.json"
    },
    {
      "id": "parquet-snapshot",
      "title": "Parquet: полный versioned snapshot",
      "request": "https://qz.energy/api/v1/datasets/energy-indicators/data.parquet",
      "curl": "curl -fL 'https://qz.energy/api/v1/datasets/energy-indicators/data.parquet' -o energy-indicators.parquet"
    }
  ],
  "bulk_download_url": "https://qz.energy/data/kk/datapackage.json",
  "revision_history_url": "https://qz.energy/data/kk/release-history.json",
  "release_permalink": "https://qz.energy/api/v1/releases.json?release_id=qz-energy-science-5ce3d74e-20260829T082900Z"
}