{
  "schema": "qz.energy.api.dataset.v1",
  "api_version": "v1",
  "product_id": "qz-energy",
  "dataset_id": "energy-balance-series",
  "stable_id": "energy-balance-series",
  "version": "qz-energy-science-5ce3d74e-20260829T082900Z",
  "release_id": "qz-energy-science-5ce3d74e-20260829T082900Z",
  "generated_at": "2026-08-29T08:28:46Z",
  "data_as_of": "2026-08-06T07:29:48Z",
  "title": "Табличные ряды топливно-энергетического баланса БНС",
  "title_i18n": {
    "ru": "Табличные ряды топливно-энергетического баланса БНС",
    "kk": "БНС-тің отын-энергетикалық теңгерімінің кестелік қатарлары",
    "en": "BNS fuel and energy balance series"
  },
  "description": "Четырнадцать сопоставимых табличных рядов БНС за 2021–2024 годы: общее первичное и конечное потребление, уголь, газ, нефть, ВИЭ, отдельные строки солнечной, ветровой энергии и биогаза, а также пять строк конечного потребления по секторам.",
  "description_i18n": {
    "ru": "Четырнадцать сопоставимых табличных рядов БНС за 2021–2024 годы: общее первичное и конечное потребление, уголь, газ, нефть, ВИЭ, отдельные строки солнечной, ветровой энергии и биогаза, а также пять строк конечного потребления по секторам.",
    "kk": "БНС-тің 2021–2024 жылдардағы он төрт салыстырмалы кестелік қатары: жалпы бастапқы және түпкілікті тұтыну, көмір, газ, мұнай, ЖЭК, күн, жел және биогаз энергиясының бөлек жолдары, сондай-ақ секторлар бойынша түпкілікті тұтынудың бес жолы.",
    "en": "Fourteen BNS table series for primary and final energy consumption, fuel groups, renewables, solar, wind, biogas and final consumption by sector in 2021–2024, with source references for each observation."
  },
  "domain": "demand",
  "period_coverage": "2021–2024",
  "granularity": "годовой ряд",
  "unit_family": "тыс. т н.э.",
  "source_class": "официальная статистика",
  "primary_source": "Бюро национальной статистики РК, XLSX топливно-энергетического баланса",
  "source_urls": [
    "https://stat.gov.kz/api/iblock/element/205511/file/ru/",
    "https://stat.gov.kz/api/iblock/element/205552/file/ru/",
    "https://stat.gov.kz/api/iblock/element/335613/file/ru/",
    "https://stat.gov.kz/api/iblock/element/37805/file/ru/"
  ],
  "freshness_status": "reviewed_static",
  "coverage_status": "table_series",
  "coverage_note": "14 рядов и 56 наблюдений; для каждого года сохранена точная ссылка на лист, строку и колонку источника.",
  "license_note": "Табличные значения не смешиваются с отдельными графиками БНС без проверки методики.",
  "records": 14,
  "links": {
    "self": "https://qz.energy/api/v1/datasets/energy-balance-series.json",
    "data": "https://qz.energy/api/v1/datasets/energy-balance-series/data.json",
    "source_download": "https://qz.energy/data/energy-balance-series.json",
    "schema": "https://qz.energy/data/schemas/qz-energy-resource.schema.json",
    "catalogue": "https://qz.energy/data/catalog.jsonld",
    "view": "https://qz.energy/datasets/energy-balance-series.html",
    "provenance": "https://qz.energy/api/v1/datasets/energy-balance-series/provenance.json",
    "parquet": "https://qz.energy/api/v1/datasets/energy-balance-series/data.parquet"
  },
  "distributions": [
    {
      "id": "energy-balance-series-api-snapshot",
      "format": "json",
      "media_type": "application/json",
      "access_url": "https://qz.energy/api/v1/datasets/energy-balance-series/data.json",
      "download_url": "https://qz.energy/api/v1/datasets/energy-balance-series/data.json",
      "byte_size": 37941,
      "checksum": "sha256:0fb8dbb53234ce6ab2ea733a4d3cb15482cd5c41bc5bf9e7349e84239b210ceb",
      "checksum_algorithm": "sha256"
    },
    {
      "id": "energy-balance-series-source-file",
      "format": "json",
      "media_type": "application/json",
      "access_url": "https://qz.energy/data/energy-balance-series.json",
      "download_url": "https://qz.energy/data/energy-balance-series.json",
      "byte_size": 35985,
      "checksum": "sha256:395a5182168645bd1bfb5e69c237da7fe590ce02cc089607663d35e4785148f9",
      "checksum_algorithm": "sha256"
    },
    {
      "id": "energy-balance-series-api-parquet-snapshot",
      "format": "parquet",
      "media_type": "application/vnd.apache.parquet",
      "access_url": "https://qz.energy/api/v1/datasets/energy-balance-series/data.parquet",
      "download_url": "https://qz.energy/api/v1/datasets/energy-balance-series/data.parquet",
      "byte_size": 13869,
      "checksum": "sha256:9b71a09d055928b028ddcca824003f253a58823bddb33cb2db41cc5c7f51b1ff",
      "checksum_algorithm": "sha256"
    }
  ],
  "api_capabilities": {
    "immutable_snapshot": true,
    "client_side_filters": [
      "dataset_id",
      "domain",
      "period",
      "freshness_status"
    ],
    "server_side_filters": true,
    "pagination": true,
    "csv": true,
    "json_stat": false,
    "parquet": true,
    "query_formats": [
      "json",
      "csv"
    ],
    "note": "The read-only query runtime filters the current immutable public release in JSON/CSV. Parquet is available as a full reproducible snapshot distribution."
  }
}