API access

Swagger: https://api.kpler.com/power/generations/v1/docs#/Series/get_gas_inventories_per_units_power_generations_v1_series_gas_inventories_units_get

Once you receive your API key, you can access our API using the authorization header in each query. Below is a curl command example:

curl -X 'GET' \ 'https://api.kpler.com/power/generations/v1/series/gas_inventories/units?country=AT&provider=gie&start=2022-01-01&end=2023-01-01' \ -H 'accept: application/json' \ -H 'Authorization: {API_key_xxxxxxxxxxxx}'

Query parameters

The API provides daily storage, injection and withdrawal information for all gas storage facilities grouped by country. The source of the data is Gas Infrastructure Europe on the AGSI (Aggregated Gas Storage Inventory) dataset.

Here are the 4 endpoint parameters:

Parameter	Format	Value
country*	iso code	iso code of the country (DE, AT, ES, etc). Only one country returned per query
start*	yyyy-mm-dd	first day of the query period
end*	yyyy-mm-dd	end of the query period (end date not included in the query response)
provider	gie	Gas Infrastructure Europe

API response

Field	Details
provider	name of the provider (gie)
index	list of dates queried
data	covers for each installation (identified by its EIC code): storage - amount of gas stored at a given date (in TWh) injection - amount of gas injected during a given day (in GWh) withdrawal - amount of gas withdrawn during a given day (GWh)
metadata	for each installation, the below information is provided: name country company (owner)

Below is an example of the structure of the response:

{ 
   "provider": "gie", 
   "index": [
     "2024-01-01" 
    ], 
   "data": { 
     "installation_EIC_code1": {
       "storage": [ 
         7.4871 
       ], 
       "injection": [ 
         0 
       ],
       "withdrawal": [ 
         80.8 
       ]
     }, 
     "installation_EIC_code2": {
       "storage": [ 
         7.4871 
       ], 
       "injection": [ 
         0 
       ],
       "withdrawal": [ 
         80.8 
       ]
     }
   },
   "metadata": { 
     "21W000000000095N": { 
       "name": "installation_name1", 
       "country": "COUNTRY_ISO", 
       "company": "company_EIC_code1" 
     }, 
     "59W-IGSTORAGE-0Q": { 
       "name": "installation_name2", 
       "country": "COUNTRY_ISO", 
       "company": "company_EIC_code2" 
     } 
   } 
}