Electricity Data Items

The following table includes information about the Electricity specific body data items for the Read Tariff output format RAW.

Data Item Description Type Units
firstReading A timestamp with the first available tariff reading String
(timestamp like yyyy-mm-dd hh:mm:ss.ms)
N/A
lastReading A timestamp with the last available tariff reading String
(timestamp like yyyy-mm-dd hh:mm:ss.ms)
N/A
currencyUnitsLabel Valid currency values are:
- GBP
- ECB
String N/A
currencyUnitsName Valid values are:
- Milipence
- Milicent
String N/A
standingCharge Number representing the charge. Double GBP/Euro
per day
standingChargeScale Multiplier applied to
standingCharge where scalar value is n in 10^n
Integer min -128, max 128 N/A
priceScale Multiplier applied to TOU/Block
price values where scalar value is n in 10^n
Integer min -128, max 128 N/A
primaryActiveTariffPrice Number representing the price. Integer 1000th
pence/cent per kWh
switchingTable Determines the Seasons, WeekProfiles
and DayProfiles for switching price values
Integer
(3 groups for day, week and season)
N/A
dayProfiles Defines sets of start times with
corresponding tariff actions for the specified days
Integer
(Up to 16 profiles)
N/A
weekProfiles Defines sets of tariff
actions for the specified referenced days
Integer
(Up to 4 profiles with 7 days each)
N/A
seasons Defines sets of tariff
actions for the specified season name
String N/A
specialDays Indicates which days, if any,
should be excluded from the switching table rules
Integer N/A
touPrices A 1 by 48 matrix
containing prices for Time-of-Use pricing
Integer
(48 sets with 1 price each)
N/A
blockPriceMatrix A 4 by 8 matrix
containing prices for Block pricing
Integer
(8 sets with up to 4 prices each)
N/A
blockThresholdMatrix A 3 by 8 matrix capable of
holding thresholds for controlling Block Tariffs
Double
(8 sets with up to 3 thresholds each)
N/A
message Additional information regarding
changes to the tariff within the requested range
String N/A
availableCacheRange A range of time, with start and
end dates, for the available tariff readings
String
(2 timestamps for start and end date)
N/A
start A timestamp indicating the start date of the cache String
(timestamp like yyyymmddhhmm)
N/A
end A timestamp indicating the end date of the cache String
(timestamp like yyyymmddhhmm)
N/A



The following table includes information about the Electricity specific body data items for the Read Tariff output format JSON.

Data Item Description Type Units
firstReading A timestamp with the first available tariff reading String
(timestamp like yyyymmddhhmmss)
N/A
lastReading A timestamp with the last available tariff reading String
(timestamp like yyyymmddhhmmss)
N/A
primaryActiveTariffPrice Number representing the price, with scalar applied. Double 1000th
pence/cent per kWh
standingCharge Number representing the charge, with scalar applied. Double GBP/Euro
per day
months A block with the tariff prices
for the requested days of the specified months
String N/A
days A block with the tariff time periods
and respective prices for the requested days
String
Integer
N/A
message Additional information regarding
changes to the tariff within the requested range
String N/A
availableCacheRange A range of time, with start and
end dates, for the available tariff readings
String
(2 timestamps for start and end dates)
N/A
start A timestamp indicating the start date of the cache String
(timestamp like yyyymmddhhmm)
N/A
end A timestamp indicating the end date of the cache String
(timestamp like yyyymmddhhmm)
N/A