Fields

deviceIdentifier : String

The id of the device. This field can only be provided in the output if device level readings are also requested.
registers : TimeOfUseRegistersConnection

The registers associated with this device.
Arguments
after : String
before : String
first : Int
last : Int
registerIdentifiers : [String]

The ids of the registers to get. If not provided, all registers for device will be returned.
timeOfUseUsage : [TimeOfUseUsagePeriodType]! required

Usage for this device, aggregated across all of its registers into calendar periods and split by time-of-use band according to the requested scheme. Useful as a fallback when registers is empty, e.g. for devices whose readings don't carry a register identifier.

The possible errors that can be raised are:

  • KT-CT-15504: Overlapping time-of-use activation rules.
  • KT-CT-1113: Disabled GraphQL field requested.
The example data in the variables and responses below are autogenerated values designed to resemble real inputs. They do not represent actual customer data, and in some cases may require additional validation.

Example

{ "deviceIdentifier": "32729584", "registers": TimeOfUseRegistersConnection, "timeOfUseUsage": [TimeOfUseUsagePeriodType] }