ToonAPI

production

Method
Description

GET

agreementId-production-electricity-flows-get

https://api.toon.eu/toon/v3/{agreementId}/production/electricity/flows

Get electricity production flow data.

GET

agreementId-production-electricity-data-get

https://api.toon.eu/toon/v3/{agreementId}/production/electricity/data

Get electricity production historical data.

GET

getElectricityGraphDataEneco

https://api.toon.eu/toon/v3/{agreementId}/production/electricity/graph

Get electricity production historical data.

GET

getElectricityProductionAndDelivery

https://api.toon.eu/toon/v3/{agreementId}/production/electricity/delivery

Get electricity production data with the delivery to the grid.

agreements

Method
Description

GET

getAgreements

https://api.toon.eu/toon/v3/agreements

Returns the agreementID(s) that are associated with the utility customer. The agreementID is used in subsequent calls to access the data of one particular Toon.

status

Method
Description

GET

getStatus

https://api.toon.eu/toon/v3/{agreementId}/status

Returns information about current power usage, gas usage, thermostat information and thermostat programs aswell as connected devices.

consumption

Method
Description

GET

getGasFlowData

https://api.toon.eu/toon/v3/{agreementId}/consumption/gas/flows

Returns the gas consumption for a given time period in 5 minute intervals. The data is given for the time period between the given from- and toTime parameters. If no parameters are specified, the default value will be used, which is the last 24 hours.

GET

getElectricityGraphData

https://api.toon.eu/toon/v3/{agreementId}/consumption/electricity/data

Returns the electricity consumption for a given time period. The data is given in the interval you specify and for the time period between the given from- and toTime parameters. If no parameters are specified, the default values will be used. The default...

GET

getDistrictHeatGraphData

https://api.toon.eu/toon/v3/{agreementId}/consumption/districtheat/data

Returns the districtheat consumption for a given time period. The data is given in the interval you specify and for the time period between the given from- and toTime parameters. If no parameters are specified, the default values will be used. The...

GET

getElectricityFlowData

https://api.toon.eu/toon/v3/{agreementId}/consumption/electricity/flows

Returns the electricity consumption for a given time period in 5 minute intervals. The data is given for the time period between the given from- and toTime parameters. The data will be returned in an array appended under the field �??hours�??. If no...

GET

getGasGraphData

https://api.toon.eu/toon/v3/{agreementId}/consumption/gas/data

Returns the gas consumption for a given time period. The data is given in the interval you specify and for the time period between the given from- and toTime parameters. If no parameters are specified, the default values will be used. The default time...

DELETE

unsubscribePushEvent

https://api.toon.eu/toon/v3/{agreementId}/webhooks/{applicationId}

The operation allows an API client to unsubscribe a push event request

GET

getWebhooks

https://api.toon.eu/toon/v3/{agreementId}/webhooks

Get list of webhooks for current cliend id to provided display

POST

subscribeToPushEvent

https://api.toon.eu/toon/v3/{agreementId}/webhooks

The operation allows an API client to subscribe a push event request, which will permit to get the display status including all datasets via a push event whenever display sends an update to the backend API

thermostat

Method
Description

GET

getThermostatPrograms

https://api.toon.eu/toon/v3/{agreementId}/thermostat/programs

Returns the different programs that are configured on the display. This regulates what the temperature will be at a certain time period. The programs indicate the time period, while also containing the used temperature state at that time. The temperature...

PUT

updateThermostatPrograms

https://api.toon.eu/toon/v3/{agreementId}/thermostat/programs

This method is currently not implemented.

PUT

setThermostatState

https://api.toon.eu/toon/v3/{agreementId}/thermostat/states

With this method you can change the different thermostat states that are available for programming. In other words you can change the temperature value of Thuis, Weg, Slapen and Comfort.

GET

getThermostatStates

https://api.toon.eu/toon/v3/{agreementId}/thermostat/states

Returns the different temperature state (setting) for the display. The temperature programs define in what state the display will go at a certain time and the state then defines the temperature value to use.

PUT

updateCurrentTemperature

https://api.toon.eu/toon/v3/{agreementId}/thermostat

Change the thermostat information

GET

getCurrentTemperature

https://api.toon.eu/toon/v3/{agreementId}/thermostat

Gets the current thermostat information

devices

Method
Description

GET

getDeviceConfiguration

https://api.toon.eu/toon/v3/{agreementId}/devices/{deviceid}

Returns information about the device that belongs to the supplied deviceid. The deviceid can contain special characters that must be URL encoded.

PUT

updateDeviceConfiguration

https://api.toon.eu/toon/v3/{agreementId}/devices/{deviceid}

You need to send the configuration of the specific device as body. This configuration can be copied directly from the result from the corresponding GET. The deviceid can contain special characters that must be URL encoded.

GET

getDevicesGraphData

https://api.toon.eu/toon/v3/{agreementId}/devices/{deviceid}/data

Can be used to retrieve the historical data for a connected device. The deviceid can contain special characters that must be URL encoded.

GET

getDevicesConfiguration

https://api.toon.eu/toon/v3/{agreementId}/devices

Returns a list of all the connected devices and their configuration. These can be Smart Plugs, Philips Hues, etc.

PUT

updateDevicesConfiguration

https://api.toon.eu/toon/v3/{agreementId}/devices

Can be used to update the configuration of all connected devices. You need to send the complete array of devices as body. The body can be copied directly from the result from GET /devices.

GET

getDevicesFlows

https://api.toon.eu/toon/v3/{agreementId}/devices/{deviceid}/flows

Can be used to retrieve the current data for a connected device. The deviceid can contain special characters that must be URL encoded.
© Copyright Toon 2017 - All rights reserved.