Get the tariff history that is being applied to a cost resource.
GET
/resource/{id}/tariff-list
Returns the tariff history that is being applied to a cost resource. The tariffs are sourced from various areas (CADs, metering devices, manual settings). The effective dates can be used to determined what the period of a particular tariff is. Please note the following 3 things.
- Fistly, the response is not sorted, we recommend it to be sorted by effective date.
- Secondly, there are multiple types of tariffs i.e. flat rate, time of use, block and and dynamic. The dynamic tariffs can change each half-hour and therefore, for the period that is affected we will return the code of the dynamic code. More information on the rates will need to be requested individually.
- Thirdly, for DCC compatible smart meters in the UK, please note that we cannot retrieve the tariff history before the time of registration. The tariff history will need to be set over the API by a user (this is a feature which will soon be available).
Request
Path Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/resource/string/tariff-list' \
--header 'Accept: application/json' \
--header 'token: <api-key>'Response Response Example
200 - OK
{
"value": "<Error: Could not resolve allOf schema"
}Modified at 2025-09-21 08:26:55