> ## 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. # Asset Management (Master Data) > Pushed when an asset (chargebox or circuit) registered with the actor is subscribed, unsubscribed, or updated. Update messages only include the fields that changed. ## AsyncAPI ````yaml openapi/smart-charging/asyncapi.yaml masterData id: masterData title: Asset Management (Master Data) description: | Pushed when an asset (chargebox or circuit) registered with the actor is subscribed, unsubscribed, or updated. Update messages only include the fields that changed. servers: - id: sns protocol: sns host: sns.amazonaws.com bindings: [] variables: [] address: master-data parameters: [] bindings: - protocol: sns version: latest value: name: master-data schemaProperties: - name: name type: string description: master-data required: false operations: - &ref_15 id: receiveMasterData title: Receive an asset management update type: receive messages: - &ref_16 id: chargeboxAssetSubscribed contentType: application/json payload: - name: Chargebox Asset Subscribed description: A chargebox has been placed under this actor's control. type: object properties: - name: asset_id type: integer description: Chargebox id. required: true - name: timestamp type: string description: >- ISO 8601 timestamp of when the action that triggered this message occurred. 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: version type: integer description: Schema version of this master-data message. Currently `1`. required: true - name: action type: string description: >- The action that triggered this message. Always `ASSET_SUBSCRIBED` for this message type. required: true - name: asset_type type: string description: >- The type of asset this message concerns. Always `CHARGEBOX` for chargebox master-data messages. required: true - name: capability type: string description: >- The control capability this message refers to. Always `SET_EVSE_INPUT_LIMIT` for chargebox master-data messages. required: true - name: connectors type: array required: true properties: - name: connector_id type: integer required: true - name: chargebox_id type: integer required: true - name: current_type type: string enumValues: - AC - DC required: true - name: input_voltage type: number required: true - name: input_phases type: integer required: true - name: max_current type: number required: true - name: min_current type: &ref_0 - number - 'null' required: true - name: schedules type: array required: true properties: - name: id type: integer required: true - name: is_enabled type: boolean required: true - name: start type: string description: Time of day the schedule starts, in `HH:mm:ss`. required: true - name: end type: string description: Time of day the schedule ends, in `HH:mm:ss`. required: true - name: connector_id type: integer required: true - name: chargebox_id type: integer required: true - name: balance_responsible_party type: object required: false properties: - name: code type: string required: true - name: encoding type: string required: true - name: retailer type: object required: false properties: - name: code type: string required: true - name: encoding type: string required: true - name: operator_id type: integer required: false headers: [] jsonPayloadSchema: type: object properties: asset_id: type: integer description: Chargebox id. x-parser-schema-id: timestamp: &ref_2 type: string format: date-time description: >- ISO 8601 timestamp of when the action that triggered this message occurred. x-parser-schema-id: ActionTimestamp 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: version: type: integer description: Schema version of this master-data message. Currently `1`. x-parser-schema-id: action: &ref_7 type: string const: ASSET_SUBSCRIBED description: >- The action that triggered this message. Always `ASSET_SUBSCRIBED` for this message type. x-parser-schema-id: ActionAssetSubscribed asset_type: &ref_3 type: string const: CHARGEBOX description: >- The type of asset this message concerns. Always `CHARGEBOX` for chargebox master-data messages. x-parser-schema-id: AssetTypeChargebox capability: &ref_4 type: string const: SET_EVSE_INPUT_LIMIT description: >- The control capability this message refers to. Always `SET_EVSE_INPUT_LIMIT` for chargebox master-data messages. x-parser-schema-id: CapabilityEvseInputLimit connectors: type: array items: &ref_8 type: object description: >- Full connector attributes, as sent when a chargebox/circuit is first subscribed. properties: connector_id: type: integer x-parser-schema-id: chargebox_id: type: integer x-parser-schema-id: current_type: type: string enum: - AC - DC x-parser-schema-id: input_voltage: type: number x-parser-schema-id: input_phases: type: integer x-parser-schema-id: max_current: type: number x-parser-schema-id: min_current: type: *ref_0 x-parser-schema-id: required: - connector_id - chargebox_id - current_type - input_voltage - input_phases - max_current - min_current x-parser-schema-id: ConnectorFull x-parser-schema-id: schedules: type: array items: &ref_9 type: object description: >- Full schedule attributes, as sent when a chargebox/circuit is first subscribed. properties: id: type: integer x-parser-schema-id: is_enabled: type: boolean x-parser-schema-id: start: type: string format: time description: Time of day the schedule starts, in `HH:mm:ss`. x-parser-schema-id: end: type: string format: time description: Time of day the schedule ends, in `HH:mm:ss`. x-parser-schema-id: connector_id: type: integer x-parser-schema-id: chargebox_id: type: integer x-parser-schema-id: required: - id - is_enabled - start - end - connector_id - chargebox_id x-parser-schema-id: ScheduleFull x-parser-schema-id: balance_responsible_party: &ref_1 type: object properties: code: type: string x-parser-schema-id: encoding: type: string x-parser-schema-id: required: - code - encoding x-parser-schema-id: MarketParty retailer: *ref_1 operator_id: type: integer x-parser-schema-id: required: - asset_id - timestamp - power_grid_zone - version - action - asset_type - capability - connectors - schedules x-parser-schema-id: ChargeboxAssetSubscribed title: Chargebox Asset Subscribed description: A chargebox has been placed under this actor's control. example: |- { "asset_id": 123456, "timestamp": "2026-10-31T08:00:00.000Z", "power_grid_zone": "DK2", "version": 1, "action": "ASSET_SUBSCRIBED", "asset_type": "CHARGEBOX", "capability": "SET_EVSE_INPUT_LIMIT", "connectors": [ { "connector_id": 1, "chargebox_id": 123456, "current_type": "AC", "input_voltage": 230, "input_phases": 3, "max_current": 32, "min_current": 0 } ], "schedules": [ { "id": 1, "is_enabled": true, "start": "22:00:00", "end": "06:00:00", "connector_id": 1, "chargebox_id": 123456 } ], "balance_responsible_party": { "code": "BRP", "encoding": "E17" }, "retailer": { "code": "RET", "encoding": "E17" }, "operator_id": 12 } bindings: [] extensions: - id: x-parser-unique-object-id value: chargeboxAssetSubscribed - &ref_17 id: chargeboxAssetUnsubscribed contentType: application/json payload: - name: Chargebox Asset Unsubscribed description: A chargebox has been removed from this actor's control. type: object properties: - name: asset_id type: integer description: Chargebox id. required: true - name: timestamp type: string description: >- ISO 8601 timestamp of when the action that triggered this message occurred. 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: version type: integer description: Schema version of this master-data message. Currently `1`. required: true - name: action type: string description: >- The action that triggered this message. Always `ASSET_UNSUBSCRIBED` for this message type. required: true - name: asset_type type: string description: >- The type of asset this message concerns. Always `CHARGEBOX` for chargebox master-data messages. required: true - name: capability type: string description: >- The control capability this message refers to. Always `SET_EVSE_INPUT_LIMIT` for chargebox master-data messages. required: true - name: connectors type: array required: true properties: - name: connector_id type: integer required: true - name: chargebox_id type: integer required: true headers: [] jsonPayloadSchema: type: object properties: asset_id: type: integer description: Chargebox id. x-parser-schema-id: timestamp: *ref_2 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: version: type: integer description: Schema version of this master-data message. Currently `1`. x-parser-schema-id: action: &ref_10 type: string const: ASSET_UNSUBSCRIBED description: >- The action that triggered this message. Always `ASSET_UNSUBSCRIBED` for this message type. x-parser-schema-id: ActionAssetUnsubscribed asset_type: *ref_3 capability: *ref_4 connectors: type: array items: type: object description: Bare connector reference, as sent on unsubscribe. properties: connector_id: type: integer x-parser-schema-id: chargebox_id: type: integer x-parser-schema-id: required: - connector_id - chargebox_id x-parser-schema-id: ConnectorRef x-parser-schema-id: required: - asset_id - timestamp - power_grid_zone - version - action - asset_type - capability - connectors x-parser-schema-id: ChargeboxAssetUnsubscribed title: Chargebox Asset Unsubscribed description: A chargebox has been removed from this actor's control. example: |- { "asset_id": 123456, "timestamp": "2026-10-31T08:00:00.000Z", "power_grid_zone": "DK2", "version": 1, "action": "ASSET_UNSUBSCRIBED", "asset_type": "CHARGEBOX", "capability": "SET_EVSE_INPUT_LIMIT", "connectors": [ { "connector_id": 1, "chargebox_id": 123456 } ] } bindings: [] extensions: - id: x-parser-unique-object-id value: chargeboxAssetUnsubscribed - &ref_18 id: chargeboxScheduleUpdated contentType: application/json payload: - name: Chargebox Schedule Updated description: One or more charging schedules on a controlled chargebox changed. type: object properties: - name: asset_id type: integer description: Chargebox id. required: true - name: timestamp type: string description: >- ISO 8601 timestamp of when the action that triggered this message occurred. 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: version type: integer description: Schema version of this master-data message. Currently `1`. required: true - name: action type: string description: >- The action that triggered this message. Always `ASSET_UPDATED` for this message type. required: true - name: asset_type type: string description: >- The type of asset this message concerns. Always `CHARGEBOX` for chargebox master-data messages. required: true - name: capability type: string description: >- The control capability this message refers to. Always `SET_EVSE_INPUT_LIMIT` for chargebox master-data messages. required: true - name: schedules type: array required: true properties: - name: id type: integer required: true - name: is_enabled type: boolean required: true - name: start type: string description: Time of day the schedule starts, in `HH:mm:ss`. required: false - name: end type: string description: Time of day the schedule ends, in `HH:mm:ss`. required: false - name: connector_id type: integer required: true - name: chargebox_id type: integer required: true headers: [] jsonPayloadSchema: type: object properties: asset_id: type: integer description: Chargebox id. x-parser-schema-id: timestamp: *ref_2 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: version: type: integer description: Schema version of this master-data message. Currently `1`. x-parser-schema-id: action: &ref_5 type: string const: ASSET_UPDATED description: >- The action that triggered this message. Always `ASSET_UPDATED` for this message type. x-parser-schema-id: ActionAssetUpdated asset_type: *ref_3 capability: *ref_4 schedules: type: array items: &ref_13 type: object description: Only fields that changed are present in update messages. properties: id: type: integer x-parser-schema-id: is_enabled: type: boolean x-parser-schema-id: start: type: string format: time description: Time of day the schedule starts, in `HH:mm:ss`. x-parser-schema-id: end: type: string format: time description: Time of day the schedule ends, in `HH:mm:ss`. x-parser-schema-id: connector_id: type: integer x-parser-schema-id: chargebox_id: type: integer x-parser-schema-id: required: - id - is_enabled - connector_id - chargebox_id x-parser-schema-id: Schedule x-parser-schema-id: required: - asset_id - timestamp - power_grid_zone - version - action - asset_type - capability - schedules x-parser-schema-id: ChargeboxScheduleUpdated title: Chargebox Schedule Updated description: One or more charging schedules on a controlled chargebox changed. example: |- { "asset_id": 123456, "timestamp": "2026-10-31T08:00:00.000Z", "power_grid_zone": "DK2", "version": 1, "action": "ASSET_UPDATED", "asset_type": "CHARGEBOX", "capability": "SET_EVSE_INPUT_LIMIT", "schedules": [ { "id": 1, "is_enabled": false, "connector_id": 1, "chargebox_id": 123456 }, { "id": 2, "is_enabled": true, "connector_id": 2, "chargebox_id": 123456, "start": "22:00:00", "end": "06:00:00" } ] } bindings: [] extensions: - id: x-parser-unique-object-id value: chargeboxScheduleUpdated - &ref_19 id: chargeboxConnectorsUpdated contentType: application/json payload: - name: Chargebox Connectors Updated description: Connector attributes on a controlled chargebox changed. type: object properties: - name: asset_id type: integer description: Chargebox id. required: true - name: timestamp type: string description: >- ISO 8601 timestamp of when the action that triggered this message occurred. 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: version type: integer description: Schema version of this master-data message. Currently `1`. required: true - name: action type: string description: >- The action that triggered this message. Always `ASSET_UPDATED` for this message type. required: true - name: asset_type type: string description: >- The type of asset this message concerns. Always `CHARGEBOX` for chargebox master-data messages. required: true - name: capability type: string description: >- The control capability this message refers to. Always `SET_EVSE_INPUT_LIMIT` for chargebox master-data messages. required: true - name: connectors type: array required: true properties: - name: connector_id type: integer required: true - name: chargebox_id type: integer required: true - name: current_type type: string enumValues: - AC - DC required: false - name: input_voltage type: number required: false - name: input_phases type: integer required: false - name: max_current type: number required: false - name: min_current type: &ref_6 - number - 'null' required: false headers: [] jsonPayloadSchema: type: object properties: asset_id: type: integer description: Chargebox id. x-parser-schema-id: timestamp: *ref_2 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: version: type: integer description: Schema version of this master-data message. Currently `1`. x-parser-schema-id: action: *ref_5 asset_type: *ref_3 capability: *ref_4 connectors: type: array items: type: object description: Only fields that changed are present in update messages. properties: connector_id: type: integer x-parser-schema-id: chargebox_id: type: integer x-parser-schema-id: current_type: type: string enum: - AC - DC x-parser-schema-id: input_voltage: type: number x-parser-schema-id: input_phases: type: integer x-parser-schema-id: max_current: type: number x-parser-schema-id: min_current: type: *ref_6 x-parser-schema-id: required: - connector_id - chargebox_id x-parser-schema-id: Connector x-parser-schema-id: required: - asset_id - timestamp - power_grid_zone - version - action - asset_type - capability - connectors x-parser-schema-id: ChargeboxConnectorsUpdated title: Chargebox Connectors Updated description: Connector attributes on a controlled chargebox changed. example: |- { "asset_id": 123456, "timestamp": "2026-10-31T08:00:00.000Z", "power_grid_zone": "DK2", "version": 1, "action": "ASSET_UPDATED", "asset_type": "CHARGEBOX", "capability": "SET_EVSE_INPUT_LIMIT", "connectors": [ { "connector_id": 1, "chargebox_id": 123456, "max_current": 16 } ] } bindings: [] extensions: - id: x-parser-unique-object-id value: chargeboxConnectorsUpdated - &ref_20 id: chargeboxMarketUpdated contentType: application/json payload: - name: Chargebox Market Info Updated description: Market/retailer attributes of a controlled chargebox changed. type: object properties: - name: asset_id type: integer description: Chargebox id. required: true - name: timestamp type: string description: >- ISO 8601 timestamp of when the action that triggered this message occurred. 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: version type: integer description: Schema version of this master-data message. Currently `1`. required: true - name: action type: string description: >- The action that triggered this message. Always `ASSET_UPDATED` for this message type. required: true - name: asset_type type: string description: >- The type of asset this message concerns. Always `CHARGEBOX` for chargebox master-data messages. required: true - name: capability type: string description: >- The control capability this message refers to. Always `SET_EVSE_INPUT_LIMIT` for chargebox master-data messages. required: true - name: balance_responsible_party type: object required: false properties: - name: code type: string required: true - name: encoding type: string required: true - name: retailer type: object required: false properties: - name: code type: string required: true - name: encoding type: string required: true - name: operator_id type: integer required: false headers: [] jsonPayloadSchema: type: object properties: asset_id: type: integer description: Chargebox id. x-parser-schema-id: timestamp: *ref_2 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: version: type: integer description: Schema version of this master-data message. Currently `1`. x-parser-schema-id: action: *ref_5 asset_type: *ref_3 capability: *ref_4 balance_responsible_party: *ref_1 retailer: *ref_1 operator_id: type: integer x-parser-schema-id: required: - asset_id - timestamp - power_grid_zone - version - action - asset_type - capability x-parser-schema-id: ChargeboxMarketUpdated title: Chargebox Market Info Updated description: Market/retailer attributes of a controlled chargebox changed. example: |- { "asset_id": 123456, "timestamp": "2026-10-31T08:00:00.000Z", "power_grid_zone": "DK2", "version": 1, "action": "ASSET_UPDATED", "asset_type": "CHARGEBOX", "capability": "SET_EVSE_INPUT_LIMIT", "retailer": { "code": "RET2", "encoding": "E17" }, "operator_id": 15 } bindings: [] extensions: - id: x-parser-unique-object-id value: chargeboxMarketUpdated - &ref_21 id: circuitAssetSubscribed contentType: application/json payload: - name: Circuit Asset Subscribed description: A circuit has been placed under this actor's control. type: object properties: - name: asset_id type: integer description: Circuit id. required: true - name: timestamp type: string description: >- ISO 8601 timestamp of when the action that triggered this message occurred. 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: version type: integer description: Schema version of this master-data message. Currently `1`. required: true - name: action type: string description: >- The action that triggered this message. Always `ASSET_SUBSCRIBED` for this message type. required: true - name: asset_type type: string description: >- The type of asset this message concerns. Always `CIRCUIT` for circuit master-data messages. required: true - name: capability type: string description: >- The control capability this message refers to. Always `SET_CIRCUIT_FUSE_LIMIT` for circuit master-data messages. required: true - name: connectors type: array required: true properties: - name: connector_id type: integer required: true - name: chargebox_id type: integer required: true - name: current_type type: string enumValues: - AC - DC required: true - name: input_voltage type: number required: true - name: input_phases type: integer required: true - name: max_current type: number required: true - name: min_current type: *ref_0 required: true - name: schedules type: array required: true properties: - name: id type: integer required: true - name: is_enabled type: boolean required: true - name: start type: string description: Time of day the schedule starts, in `HH:mm:ss`. required: true - name: end type: string description: Time of day the schedule ends, in `HH:mm:ss`. required: true - name: connector_id type: integer required: true - name: chargebox_id type: integer required: true - name: max_capacity type: number description: Circuit fuse capacity, in Amps. required: true headers: [] jsonPayloadSchema: type: object properties: asset_id: type: integer description: Circuit id. x-parser-schema-id: timestamp: *ref_2 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: version: type: integer description: Schema version of this master-data message. Currently `1`. x-parser-schema-id: action: *ref_7 asset_type: &ref_11 type: string const: CIRCUIT description: >- The type of asset this message concerns. Always `CIRCUIT` for circuit master-data messages. x-parser-schema-id: AssetTypeCircuit capability: &ref_12 type: string const: SET_CIRCUIT_FUSE_LIMIT description: >- The control capability this message refers to. Always `SET_CIRCUIT_FUSE_LIMIT` for circuit master-data messages. x-parser-schema-id: CapabilityCircuitFuseLimit connectors: type: array items: *ref_8 x-parser-schema-id: schedules: type: array items: *ref_9 x-parser-schema-id: max_capacity: type: number description: Circuit fuse capacity, in Amps. x-parser-schema-id: required: - asset_id - timestamp - power_grid_zone - version - action - asset_type - capability - connectors - schedules - max_capacity x-parser-schema-id: CircuitAssetSubscribed title: Circuit Asset Subscribed description: A circuit has been placed under this actor's control. example: |- { "asset_id": 42, "timestamp": "2026-10-31T08:00:00.000Z", "power_grid_zone": "DK2", "version": 1, "action": "ASSET_SUBSCRIBED", "asset_type": "CIRCUIT", "capability": "SET_CIRCUIT_FUSE_LIMIT", "connectors": [ { "connector_id": 1, "chargebox_id": 123456, "current_type": "AC", "input_voltage": 230, "input_phases": 3, "max_current": 32, "min_current": 0 } ], "schedules": [ { "id": 1, "is_enabled": true, "start": "22:00:00", "end": "06:00:00", "connector_id": 1, "chargebox_id": 123456 } ], "max_capacity": 200 } bindings: [] extensions: - id: x-parser-unique-object-id value: circuitAssetSubscribed - &ref_22 id: circuitAssetUnsubscribed contentType: application/json payload: - name: Circuit Asset Unsubscribed description: A circuit has been removed from this actor's control. type: object properties: - name: asset_id type: integer description: Circuit id. required: true - name: timestamp type: string description: >- ISO 8601 timestamp of when the action that triggered this message occurred. 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: version type: integer description: Schema version of this master-data message. Currently `1`. required: true - name: action type: string description: >- The action that triggered this message. Always `ASSET_UNSUBSCRIBED` for this message type. required: true - name: asset_type type: string description: >- The type of asset this message concerns. Always `CIRCUIT` for circuit master-data messages. required: true - name: capability type: string description: >- The control capability this message refers to. Always `SET_CIRCUIT_FUSE_LIMIT` for circuit master-data messages. required: true headers: [] jsonPayloadSchema: type: object properties: asset_id: type: integer description: Circuit id. x-parser-schema-id: timestamp: *ref_2 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: version: type: integer description: Schema version of this master-data message. Currently `1`. x-parser-schema-id: action: *ref_10 asset_type: *ref_11 capability: *ref_12 required: - asset_id - timestamp - power_grid_zone - version - action - asset_type - capability x-parser-schema-id: CircuitAssetUnsubscribed title: Circuit Asset Unsubscribed description: A circuit has been removed from this actor's control. example: |- { "asset_id": 42, "timestamp": "2026-10-31T08:00:00.000Z", "power_grid_zone": "DK2", "version": 1, "action": "ASSET_UNSUBSCRIBED", "asset_type": "CIRCUIT", "capability": "SET_CIRCUIT_FUSE_LIMIT" } bindings: [] extensions: - id: x-parser-unique-object-id value: circuitAssetUnsubscribed - &ref_23 id: circuitLimitsUpdated contentType: application/json payload: - name: Circuit Limits Updated description: The circuit's capacity or DLM enablement changed. type: object properties: - name: asset_id type: integer description: Circuit id. required: true - name: timestamp type: string description: >- ISO 8601 timestamp of when the action that triggered this message occurred. 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: version type: integer description: Schema version of this master-data message. Currently `1`. required: true - name: action type: string description: >- The action that triggered this message. Always `ASSET_UPDATED` for this message type. required: true - name: asset_type type: string description: >- The type of asset this message concerns. Always `CIRCUIT` for circuit master-data messages. required: true - name: capability type: string description: >- The control capability this message refers to. Always `SET_CIRCUIT_FUSE_LIMIT` for circuit master-data messages. required: true - name: max_capacity type: number description: Circuit fuse capacity, in Amps. required: false - name: is_load_management_enabled type: boolean required: false headers: [] jsonPayloadSchema: type: object properties: asset_id: type: integer description: Circuit id. x-parser-schema-id: timestamp: *ref_2 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: version: type: integer description: Schema version of this master-data message. Currently `1`. x-parser-schema-id: action: *ref_5 asset_type: *ref_11 capability: *ref_12 max_capacity: type: number description: Circuit fuse capacity, in Amps. x-parser-schema-id: is_load_management_enabled: type: boolean x-parser-schema-id: required: - asset_id - timestamp - power_grid_zone - version - action - asset_type - capability x-parser-schema-id: CircuitLimitsUpdated title: Circuit Limits Updated description: The circuit's capacity or DLM enablement changed. example: |- { "asset_id": 42, "timestamp": "2026-10-31T08:00:00.000Z", "power_grid_zone": "DK2", "version": 1, "action": "ASSET_UPDATED", "asset_type": "CIRCUIT", "capability": "SET_CIRCUIT_FUSE_LIMIT", "max_capacity": 250, "is_load_management_enabled": true } bindings: [] extensions: - id: x-parser-unique-object-id value: circuitLimitsUpdated - &ref_24 id: circuitScheduleUpdated contentType: application/json payload: - name: Circuit Schedule Updated description: One or more charging schedules on a controlled circuit changed. type: object properties: - name: asset_id type: integer description: Circuit id. required: true - name: timestamp type: string description: >- ISO 8601 timestamp of when the action that triggered this message occurred. 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: version type: integer description: Schema version of this master-data message. Currently `1`. required: true - name: action type: string description: >- The action that triggered this message. Always `ASSET_UPDATED` for this message type. required: true - name: asset_type type: string description: >- The type of asset this message concerns. Always `CIRCUIT` for circuit master-data messages. required: true - name: capability type: string description: >- The control capability this message refers to. Always `SET_CIRCUIT_FUSE_LIMIT` for circuit master-data messages. required: true - name: schedules type: array required: true properties: - name: id type: integer required: true - name: is_enabled type: boolean required: true - name: start type: string description: Time of day the schedule starts, in `HH:mm:ss`. required: false - name: end type: string description: Time of day the schedule ends, in `HH:mm:ss`. required: false - name: connector_id type: integer required: true - name: chargebox_id type: integer required: true headers: [] jsonPayloadSchema: type: object properties: asset_id: type: integer description: Circuit id. x-parser-schema-id: timestamp: *ref_2 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: version: type: integer description: Schema version of this master-data message. Currently `1`. x-parser-schema-id: action: *ref_5 asset_type: *ref_11 capability: *ref_12 schedules: type: array items: *ref_13 x-parser-schema-id: required: - asset_id - timestamp - power_grid_zone - version - action - asset_type - capability - schedules x-parser-schema-id: CircuitScheduleUpdated title: Circuit Schedule Updated description: One or more charging schedules on a controlled circuit changed. example: |- { "asset_id": 42, "timestamp": "2026-10-31T08:00:00.000Z", "power_grid_zone": "DK2", "version": 1, "action": "ASSET_UPDATED", "asset_type": "CIRCUIT", "capability": "SET_CIRCUIT_FUSE_LIMIT", "schedules": [ { "id": 1, "is_enabled": false, "connector_id": 1, "chargebox_id": 123456 } ] } bindings: [] extensions: - id: x-parser-unique-object-id value: circuitScheduleUpdated - &ref_25 id: circuitConnectorsUpdated contentType: application/json payload: - name: Circuit Connectors Updated description: >- Connectors were added to, removed from, or updated on a controlled circuit. type: object properties: - name: asset_id type: integer description: Circuit id. required: true - name: timestamp type: string description: >- ISO 8601 timestamp of when the action that triggered this message occurred. 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: version type: integer description: Schema version of this master-data message. Currently `1`. required: true - name: action type: string description: >- The action that triggered this message. Always `ASSET_UPDATED` for this message type. required: true - name: asset_type type: string description: >- The type of asset this message concerns. Always `CIRCUIT` for circuit master-data messages. required: true - name: capability type: string description: >- The control capability this message refers to. Always `SET_CIRCUIT_FUSE_LIMIT` for circuit master-data messages. required: true - name: connectors type: array required: true properties: - name: connector_id type: integer required: true - name: chargebox_id type: integer required: true - name: update_type type: string enumValues: - ADDED - REMOVED - UPDATED required: true - name: current_type type: string enumValues: - AC - DC required: false - name: input_voltage type: number required: false - name: input_phases type: integer required: false - name: max_current type: number required: false - name: min_current type: &ref_14 - number - 'null' required: false headers: [] jsonPayloadSchema: type: object properties: asset_id: type: integer description: Circuit id. x-parser-schema-id: timestamp: *ref_2 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: version: type: integer description: Schema version of this master-data message. Currently `1`. x-parser-schema-id: action: *ref_5 asset_type: *ref_11 capability: *ref_12 connectors: type: array items: type: object properties: connector_id: type: integer x-parser-schema-id: chargebox_id: type: integer x-parser-schema-id: update_type: type: string enum: - ADDED - REMOVED - UPDATED x-parser-schema-id: current_type: type: string enum: - AC - DC x-parser-schema-id: input_voltage: type: number x-parser-schema-id: input_phases: type: integer x-parser-schema-id: max_current: type: number x-parser-schema-id: min_current: type: *ref_14 x-parser-schema-id: required: - connector_id - chargebox_id - update_type x-parser-schema-id: CircuitConnectorUpdate x-parser-schema-id: required: - asset_id - timestamp - power_grid_zone - version - action - asset_type - capability - connectors x-parser-schema-id: CircuitConnectorsUpdated title: Circuit Connectors Updated description: >- Connectors were added to, removed from, or updated on a controlled circuit. example: |- { "asset_id": 42, "timestamp": "2026-10-31T08:00:00.000Z", "power_grid_zone": "DK2", "version": 1, "action": "ASSET_UPDATED", "asset_type": "CIRCUIT", "capability": "SET_CIRCUIT_FUSE_LIMIT", "connectors": [ { "connector_id": 2, "chargebox_id": 123457, "update_type": "ADDED", "current_type": "AC", "input_voltage": 230, "input_phases": 1, "max_current": 16, "min_current": 6 } ] } bindings: [] extensions: - id: x-parser-unique-object-id value: circuitConnectorsUpdated bindings: [] extensions: - id: x-parser-unique-object-id value: masterData sendOperations: - *ref_15 receiveOperations: [] sendMessages: - *ref_16 - *ref_17 - *ref_18 - *ref_19 - *ref_20 - *ref_21 - *ref_22 - *ref_23 - *ref_24 - *ref_25 receiveMessages: [] extensions: - id: x-parser-unique-object-id value: masterData 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: [] ````