> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spirii.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Power Measurements

> Near-real-time active power readings for chargeboxes and circuits
registered with the actor.




## AsyncAPI

````yaml openapi/smart-charging/asyncapi.yaml powerMeasurements
id: powerMeasurements
title: Power Measurements
description: |
  Near-real-time active power readings for chargeboxes and circuits
  registered with the actor.
servers:
  - id: sns
    protocol: sns
    host: sns.amazonaws.com
    bindings: []
    variables: []
address: power-measurements
parameters: []
bindings:
  - protocol: sns
    version: latest
    value:
      name: power-measurements
    schemaProperties:
      - name: name
        type: string
        description: power-measurements
        required: false
operations:
  - &ref_1
    id: receivePowerMeasurement
    title: Receive a power measurement
    type: receive
    messages:
      - &ref_2
        id: powerMeasurement
        contentType: application/json
        payload:
          - name: Power Measurement
            type: object
            properties:
              - name: asset_id
                type: integer
                description: >-
                  Chargebox or circuit id. For circuits, the power measurement
                  is the total power draw of the entire circuit.
                required: true
              - name: asset_type
                type: string
                description: >-
                  The type of asset this message concerns. `CHARGEBOX` for
                  per-connector readings, `CIRCUIT` for whole-circuit readings.
                enumValues:
                  - CHARGEBOX
                  - CIRCUIT
                required: true
              - name: connector_id
                type: integer
                description: >-
                  Present for EVSE input limit requests, absent for circuit fuse
                  limit requests.
                required: false
              - name: active_power
                type: &ref_0
                  - number
                  - 'null'
                description: Active power, in kW.
                required: true
              - name: power_grid_zone
                type: string
                description: >-
                  Display name of the power grid zone the asset is located in,
                  e.g. `DK1`, `DK2`, `DE`, etc.
                required: true
              - name: timestamp
                type: string
                description: ISO 8601 timestamp reported by the chargebox itself.
                required: true
        headers: []
        jsonPayloadSchema:
          type: object
          description: >
            `connector_id` is present when `asset_type` is `CHARGEBOX`
            (per-connector

            reading) and absent when `asset_type` is `CIRCUIT` (whole-circuit
            reading).
          properties:
            asset_id:
              type: integer
              description: >-
                Chargebox or circuit id. For circuits, the power measurement is
                the total power draw of the entire circuit.
              x-parser-schema-id: <anonymous-schema-126>
            asset_type:
              type: string
              enum:
                - CHARGEBOX
                - CIRCUIT
              description: >-
                The type of asset this message concerns. `CHARGEBOX` for
                per-connector readings, `CIRCUIT` for whole-circuit readings.
              x-parser-schema-id: <anonymous-schema-127>
            connector_id:
              type: integer
              description: >-
                Present for EVSE input limit requests, absent for circuit fuse
                limit requests.
              x-parser-schema-id: <anonymous-schema-128>
            active_power:
              type: *ref_0
              description: Active power, in kW.
              x-parser-schema-id: <anonymous-schema-129>
            power_grid_zone:
              type: string
              description: >-
                Display name of the power grid zone the asset is located in,
                e.g. `DK1`, `DK2`, `DE`, etc.
              x-parser-schema-id: <anonymous-schema-130>
            timestamp:
              type: string
              format: date-time
              description: ISO 8601 timestamp reported by the chargebox itself.
              x-parser-schema-id: ChargeboxReportedTimestamp
          required:
            - asset_id
            - asset_type
            - active_power
            - power_grid_zone
            - timestamp
          x-parser-schema-id: PowerMeasurement
        title: Power Measurement
        example: |-
          {
            "asset_id": 123456,
            "asset_type": "CHARGEBOX",
            "connector_id": 1,
            "active_power": 7.4,
            "power_grid_zone": "DK2",
            "timestamp": "2026-10-31T08:11:12.123Z"
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: powerMeasurement
    bindings: []
    extensions:
      - id: x-parser-unique-object-id
        value: powerMeasurements
sendOperations:
  - *ref_1
receiveOperations: []
sendMessages:
  - *ref_2
receiveMessages: []
extensions:
  - id: x-parser-unique-object-id
    value: powerMeasurements
securitySchemes:
  - id: apiKey
    name: x-api-key
    type: httpApiKey
    description: |
      API key issued to the Actor during registration. Spirii can revoke and
      reissue keys at any time.
    in: header
    extensions: []

````