Skip to main content

MeteringPoint

The MeteringPoint type represents a metering point, which is a location where energy is delivered. This is the physical machine that measures the amount of energy used.

type MeteringPoint {
  id: UUID!
  contractID: UUID!
  identifier: String!
  type: MeteringPointType!
  gridOperator: String!
  capacity: String!
  usages(
    type: UsageType!
    from: Time!
    requestUnit: UsageTimeUnit! = DAYS
    requestAmount: Int! = 1
    granularity: UsageGranularity! = HOUR
  ): [Usage!]
}

Fields​

MeteringPoint.id ● UUID! non-null scalar​

The unique identifier of the metering point.

MeteringPoint.contractID ● UUID! non-null scalar​

The contract that the metering point is associated with.

MeteringPoint.identifier ● String! non-null scalar​

The (government specified) identifier of the metering point. This is used to uniquely identify the physical machine where energy is delivered.

MeteringPoint.type ● MeteringPointType! non-null enum​

The type of the metering point. This is used to specify the type of energy that is delivered at the metering point. For example, electricity or gas.

MeteringPoint.gridOperator ● String! non-null scalar​

Name of the grid operator. This is the company that manages the grid where the metering point is connected to.

MeteringPoint.capacity ● String! non-null scalar​

The capacity information of the metering point. This is used to specify the maximum amount of energy that can be delivered at the metering point. For example, 1 x 6A, 3 x 25A, G10, G16.

MeteringPoint.usages ● [Usage!] list object​

Query to retrieve the usages of a metering point over a specified time frame. These usages represent the energy used in defined periods, with a minimum duration of 1 hour.

MeteringPoint.usages.type ● UsageType! non-null enum​

type determines whether the returned object is either about consumption or production.

MeteringPoint.usages.from ● Time! non-null scalar​

The starting point in time from which the time frame is calculated.

MeteringPoint.usages.requestUnit ● UsageTimeUnit! non-null enum​

The unit of time that will define the size of the requested timeframe. If the granularity is larger than the requestUnit, it will return a bad request.

MeteringPoint.usages.requestAmount ● Int! non-null scalar​

The quantity of the specified time unit. This determines the length of the requested timeframe.

MeteringPoint.usages.granularity ● UsageGranularity! non-null enum​

The level of detail for the returned data within a requested timeframe. For example, hourly, daily or monthly granularity.

Member Of​

Contract object