tounify API
Up-to-date data through intelligent automation
tounify automatically collects the electricity tariff data from a large number of providers throughout Europe.
The built-in intelligence learns to read the tariff information pages of static tariffs and communicates continuously with the interfaces of dynamic tariffs. This means that the latest data is made available via the tounify API.
To integrate the data into your system takes only a few lines of code.
1. Get your token
To use the tounify API simply write us a short email about who you are and what your products / intentions are. We will provide you a token unique to your company shortly thereafter.
2. List energy suppliers
To get a list of energy suppliers providing time-of-use tariffs simply make a GET request to:
https://api.tounify.io/v1/energySuppliers?token=UUID_TOKEN&country=COUNTRY_CODE
The COUNTRY_CODE (in ISO 3166-1 alpha-2 format) can optionally be added as query parameter to list only energy suppliers operating in this country.
The response is in JSON format:
[
{
"id": "ESID1",
"name": "Energy Supplier 1",
"country": "AT"
},
...
{
"id": "ESID17",
"name": "Energy Supplier 2",
"country": "DE"
}
]
3. List energy tariffs
To get a list of time-of-use energy tariffs, simply make a GET request to:
https://api.tounify.io/v1/energyTariffs?token=UUID_TOKEN&country=COUNTRY_CODE&esid=ES_ID
The COUNTRY_CODE and ES_ID can optionally be added as query parameter to list only energy tariffs available in this country or from this energy supplier.
The response is in JSON format:
[
{
"id": "ETID1",
"name": "Tariff Name 1",
"esid": "ESID1",
"country": "AT",
"link": "https://www.energy-utility.com/tariff-name1"
},
...
{
"id": "ETID3",
"name": "Tariff Name 2",
"esid": "ESID17",
"country": "DE",
"link": "https://www.energy-utility.com/tariff-name2"
}
]
4. List distribution system operators
To get a list of distribution system operators (DSOs) providing time-of-use tariffs simply make a GET request to:
https://api.tounify.io/v1/dsos?token=UUID_TOKEN&country=COUNTRY_CODE
The COUNTRY_CODE (in ISO 3166-1 alpha-2 format) can optionally be added as query parameter to list only DSOs operating in this country.
The response is in JSON format:
[
{
"id": "DSOID1",
"name": "Distribution System Operator 1",
"country": "AT"
},
...
{
"id": "DSOID17",
"name": "Distribution System Operator 2",
"country": "DE"
}
]
5. List grid tariffs
To get a list of time-of-use grid tariffs, simply make a GET request to:
https://api.tounify.io/v1/gridTariffs?token=UUID_TOKEN&country=COUNTRY_CODE&dsoid=DSO_ID
The COUNTRY_CODE and DSO_ID can optionally be added as query parameter to list only grid tariffs available in this country or from this DSO.
The response is in JSON format:
[
{
"id": "GTID1",
"name": "Tariff Name 1",
"description": "Description of grid tariff details",
"dsoid": "DSOID1",
"country": "AT",
"link": "https://www.energy-utility.com/tariff-name1"
},
...
{
"id": "GTID3",
"name": "Tariff Name 2",
"description": "Description of grid tariff details",
"dsoid": "DSOID17",
"country": "DE",
"link": "https://www.energy-utility.com/tariff-name2"
}
]
6. and finally: fetch day-ahead prices
Day-Ahead prices for most tariffs will be available at about noon. Make the following GET request to retrieve the prices for the available time horizon:
https://api.tounify.io/v1/dayahead?token=UUID_TOKEN&es_tariff=ET_ID&dso_tariff=GT_ID
The ET_ID and GT_ID are the tariff IDs provided in the previous steps 3 and 5. If both energy and grid tariff IDs are provided, then the price in the values array, is the sum of the energy and grid price. The response is in JSON format:
{
"es_tariff": "ETID1",
"dso_tariff": "GTID1",
"from_utc": 1605636000,
"unit": "ct/kWh",
"step": 60,
"next": 1605639624,
"values": [
4.4,
4.43,
...
2.36
]
}
step is this time increment in minutes between each price value.
next is the UTC timestamp when we recommend to next fetch the new price information.