Skip to main content

Fields

readings : Readings

Get readings from a readable device e.g., a supply point, device, or register.

The possible errors that can be raised are:

  • KT-CT-4721: Unsupported reading type.
  • KT-CT-4729: Unknown reading extra requested.
  • KT-CT-1113: Disabled GraphQL field requested.
Arguments
endAt : DateTime! required

The exclusive end of the time period as an isoformatted string.

extras : [String!]

Optional list of extra keys to include on each reading if present on the underlying raw meter data. Note, requesting extras may cause aggregation delays with large aggregation queries.

readingType : ReadingTypes! required

Get readings of only this type.

startAt : DateTime! required

The inclusive start of the time period as an isoformatted string.

timeGranularity : TimeGranularities

Time buckets to group readings into.

timezone : String default: Europe/London

The timezone in which to return readings.

units : [Units]

Optional filter to return readings only for specific list of units or unit (e.g., KILOWATT_HOURS, METERS_CUBED, LITER, etc.).

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

{ "readings": Readings }