diff --git a/source/_integrations/tibber.markdown b/source/_integrations/tibber.markdown index 24e5cd82d48..dba887df9d2 100644 --- a/source/_integrations/tibber.markdown +++ b/source/_integrations/tibber.markdown @@ -83,6 +83,54 @@ If you have a Tibber Pulse it will also show the electricity consumption in real +## Services + +The hourly prices are exposed using [service calls](/docs/scripts/service-calls/). The services populate [response data](/docs/scripts/service-calls#use-templates-to-handle-response-data) with price data. + +### Service `tibber.get_prices` + +Fetches hourly energy prices including price level. + +| Service data attribute | Optional | Description | Example | +| ---------------------- | -------- | ----------- | --------| +| `start` | yes | Start time to get prices. Defaults to today 00:00:00 | 2024-01-01 00:00:00 | +| `end` | yes | End time to get prices. Defaults to tomorrow 00:00:00 | 2024-01-01 00:00:00 | + +#### Response data + +The response data is a dictionary with the energy prices for each Home. `start_time` is returned in local time from the API. + +```json +{ + "prices": { + "Nickname_Home":[ + { + "start_time": "2023-12-09 03:00:00+02:00", + "price": 0.46914, + "level": "VERY_EXPENSIVE" + }, + { + "start_time": "2023-12-09 04:00:00+02:00", + "price": 0.46914, + "level": "VERY_EXPENSIVE" + } + ], + "Nickname_Home_2":[ + { + "start_time": "2023-12-09 03:00:00+02:00", + "price": 0.46914, + "level": "VERY_EXPENSIVE" + }, + { + "start_time": "2023-12-09 04:00:00+02:00", + "price": 0.46914, + "level": "VERY_EXPENSIVE" + } + ] + } +} +``` + ## Examples In this section, you will find some real-life examples of how to use this sensor.