API access
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):
|
metadata | for each installation, the below information is provided:
|
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"
}
}
}