DataHub API | Instructions

This page documents the API that provides information on electricity and gas data presented on the website https://datahub.ren.pt.

The information provided by the API is in JSON format.

 

Parameters

The following parameters can be sent:

  • "culture": select the language in which you want to receive the information. (Example: "pt-PT" or "en-US").
  • "year": the year the data refers to. Format: "yyyy".
  • "month": the month the data refers to. Format: "mm".
  • "date": in some specified services, this allows you to obtain data for a specific date. Format: "yyyy-mm-dd".

GAS DATA

 

DAILY BALANCE

Data regarding the daily results of gas consumption and supply.

Required parameters: Culture, Date

  • Daily consumption - https://servicebus.ren.pt/datahubapi/gas/GasConsumptionSupplyDaily

Example: https://servicebus.ren.pt/datahubapi/gas/GasConsumptionSupplyDaily?culture=en-US&date=2025-01-25

  • Daily consumption breakdown - https://servicebus.ren.pt/datahubapi/gas/GasConsumptionBreakdownDaily

Example: https://servicebus.ren.pt/datahubapi/gas/GasConsumptionBreakdownDaily?culture=en-US&date=2025-01-25

  • Daily RNTG balance - https://servicebus.ren.pt/datahubapi/gas/GasRNTGBalanceDaily

Example: https://servicebus.ren.pt/datahubapi/gas/GasRNTGBalanceDaily?culture=en-US&date=2025-01-25

  • Daily LNG Terminal balance - https://servicebus.ren.pt/datahubapi/gas/GasLNGTerminalBalanceDaily

Example: https://servicebus.ren.pt/datahubapi/gas/GasLNGTerminalBalanceDaily?culture=en-US&date=2025-01-25

  • Daily underground storage balance - https://servicebus.ren.pt/datahubapi/gas/GasUndergroundStorageBalanceDaily

Example: https://servicebus.ren.pt/datahubapi/gas/GasUndergroundStorageBalanceDaily?culture=en-US&date=2025-01-25

 

MONTHLY BALANCE

Data regarding the monthly results of gas consumption and supply.

Required parameters: Culture; Year; Month

  • Monthly consumption - https://servicebus.ren.pt/datahubapi/gas/GasConsumptionSupplyMonthly

Example: https://servicebus.ren.pt/datahubapi/gas/GasConsumptionSupplyMonthly?culture=en-US&year=2025&month=01

  • Monthly RNTG balance - https://servicebus.ren.pt/datahubapi/gas/GasRNTGBalanceMonthly

Example: https://servicebus.ren.pt/datahubapi/gas/GasRNTGBalanceMonthly?culture=en-US&year=2025&month=01

  • Monthly LNG Terminal balance - https://servicebus.ren.pt/datahubapi/gas/GasLNGTerminalBalanceMonthly

Example: https://servicebus.ren.pt/datahubapi/gas/GasLNGTerminalBalanceMonthly?culture=en-US&year=2025&month=01

  • Monthly underground storage balance - https://servicebus.ren.pt/datahubapi/gas/GasUndergroundStorageBalanceMonthly

Example: https://servicebus.ren.pt/datahubapi/gas/GasUndergroundStorageBalanceMonthly?culture=en-US&year=2025&month=01

  • Monthly supply breakdown - https://servicebus.ren.pt/datahubapi/gas/GasBreakdownOfSupplyMonthly

Example: https://servicebus.ren.pt/datahubapi/gas/GasBreakdownOfSupplyMonthly?culture=en-US&year=2025&month=01

 

CONSUMPTION EVOLUTION

Data regarding the evolution of gas consumption throughout the year.

Required parameters: Culture; Year

  • Consumption variation - https://servicebus.ren.pt/datahubapi/gas/GasConsumptionVariationYearly

Example: https://servicebus.ren.pt/datahubapi/gas/GasConsumptionVariationYearly?culture=en-US&year=2024

 

MARKET

Data regarding the evolution of the gas market.

Required parameters: Culture; Year; Month

  • Daily market prices - https://servicebus.ren.pt/datahubapi/gas/GasMarketPricesDaily

Example: https://servicebus.ren.pt/datahubapi/gas/GasMarketPricesDaily?culture=en-US&year=2025&month=01

  • Monthly average values - https://servicebus.ren.pt/datahubapi/gas/GasMarketPricesMonthly

Example: https://servicebus.ren.pt/datahubapi/gas/GasMarketPricesMonthly?culture=en-US&year=2025&month=01

ELECTRICITY DATA

 

DAILY BALANCE

Data regarding the daily results of electricity consumption and supply.

Required parameters: Culture; Date

  • Energy balance - https://servicebus.ren.pt/datahubapi/electricity/ElectricityConsumptionSupplyDaily

Example: https://servicebus.ren.pt/datahubapi/electricity/ElectricityConsumptionSupplyDaily?culture=en-US&date=2025-01-25

  • Production breakdown - https://servicebus.ren.pt/datahubapi/electricity/ElectricityProductionBreakdownDaily

Example: https://servicebus.ren.pt/datahubapi/electricity/ElectricityProductionBreakdownDaily?culture=en-US&date=2025-01-25

 

MONTHLY BALANCE

Data regarding the monthly results of electricity consumption and supply.

Required parameters: Culture; Year; Month

  • Energy balance - https://servicebus.ren.pt/datahubapi/electricity/ElectricityConsumptionSupplyMonthly
Example: https://servicebus.ren.pt/datahubapi/electricity/ElectricityConsumptionSupplyMonthly?culture=en-US&year=2025&month=01
  • Installed power - https://servicebus.ren.pt/datahubapi/electricity/ElectricityInstalledPowerMonthly
Example: https://servicebus.ren.pt/datahubapi/electricity/ElectricityInstalledPowerMonthly?culture=en-US&year=2025&month=01

 

CONSUMPTION EVOLUTION

Data regarding the evolution of electricity consumption throughout the year.

Required parameters: Culture; Year

  • Consumption variation - https://servicebus.ren.pt/datahubapi/electricity/ElectricityConsumptionVariationYearly

Example: https://servicebus.ren.pt/datahubapi/electricity/ElectricityConsumptionVariationYearly?culture=en-US&year=2024

 

MARKET

Data regarding the evolution of the electricity market.

  • Daily market prices - https://servicebus.ren.pt/datahubapi/electricity/ElectricityMarketPricesDaily

Required parameters: Culture; Date

Example: https://servicebus.ren.pt/datahubapi/electricity/ElectricityMarketPricesDaily?culture=en-US&date=2025-01-25

  • Monthly average values - https://servicebus.ren.pt/datahubapi/electricity/ElectricityMarketPricesMonthly

Required parameters: Culture; Year; Month

Example: https://servicebus.ren.pt/datahubapi/electricity/ElectricityMarketPricesMonthly?culture=en-US&year=2025&month=01