The P1 meter has a local API to retrieve data that is currently being measured. You can access this API as long as you are connected to the same (Wi-Fi) network as the P1 meter. This API is intended to connect your P1 meter to your own automation, home automation or graphing system. It is not possible to retrieve data history with the local API.


Terms and conditions

1. License:
The HomeWizard P1 meter API is licensed, not sold. HomeWizard grants the user a non-exclusive license (with no right to sub-license) to use only one copy of the HomeWizard P1 meter API for personal, non-commercial use.

2. Usage

The user may not directly or indirectly use the HomeWizard P1 meter API to sell, lease, loan or generate a revenue from a product, system or software using the API
3. Support:
The usage of the P1 meter API is officially supported by HomeWizard, however HomeWizard can not supply customer service regarding the implementation of the API in your own or third party applications.


Type of request 

The P1 meter supports 2 methods to request data. You can request the data structured as JSON under data or you can request the raw data from the smart meter under telegram. The API provides access to the most recent update offered by the smart meter.


Data update frequency

The speed of this depends on the SMR version of your smart meter. With SMR 5.0 this is every second for power and every 5 minutes for gas. If your version is lower than SMR 5.0, this is every 10 seconds for power and every 60 minutes for gas. You can find the SMR version of your smart meter on your smart meter or via the API. There is no limit to the number of requests on the local API, however, we advise not to retrieve data more often than every 500ms.


Request data from the P1 meter

With this HTTP GET data request you can request the data from a P1 meter.


http://{IP address}/api/v1/data


In the above request, the local IP address of the P1 meter from which you want to request data must be entered at {IP address}. You will receive a response like the one below in JSON structure.

Example of P1 data response


HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 476

{
    "smr_version": 50, 
    "meter_model": "ISKRA  2M550T-101",
    "wifi_ssid": "My Wi-Fi",
    "wifi_strength": 100,
    "total_power_import_t1_kwh": 10830.511,
    "total_power_import_t2_kwh": 2948.827,
    "total_power_export_t1_kwh": 1285.951,
    "total_power_export_t2_kwh": 2876.514,
    "active_power_w": -543,
    "active_power_l1_w": -676,
    "active_power_l2_w": 133,
    "active_power_l3_w": 0,
    "total_gas_m3": 2569.646,
    "gas_timestamp": 210606140010
}



smr_version: [Number] The SMR version of the meter
meter_model: [String] The brand and type of the meter
wifi_ssid: [String] The Wi-Fi network that the meter is connected to
wifi_strength: [Number] The strength of the Wi-Fi signal in %
total_power_import_t1_kwh: [Number] The power usage meter reading for tariff 1 in kWh
total_power_import_t2_kwh: [Number] The power usage meter reading for tariff 2 in kWh
total_power_export_t1_kwh: [Number] The power feed-in meter reading for tariff 1 in kWh
total_power_export_t2_kwh: [Number] The power feed-in meter reading for tariff 2 in kWh
active_power_w: [Number] The total active usage in Watts
active_power_l1_w: [Number] The active usage for fase 1 in Watts (if applicable)
active_power_l1_w: [Number] The active usage for fase 1 in Watts (if applicable)
active_power_l2_w: [Number] The active usage for fase 2 in Watts (if applicable)
active_power_l3_w: [Number] The active usage for fase 3 in Watts (if applicable)
total_gas_m3: [Number] The gas meter reading in m3
gas_timestamp: [Number] The most recent gas update time stamp structured as YYMMDDhhmmss.



Request raw smart meter data (telegram)

With the API, the most recent telegram from the smart meter can be retrieved. This raw data is sent without adjustments by the P1 meter.


Pay Attention
Requesting a telegram is temporarily not support at the moment



http://{IP address}/api/v1/telegram


In the above request, the local IP address of the P1 meter from which you want to request data must be entered at {IP address}. You then receive the raw telegram from the smart meter via the P1 meter.

Below you can find an example of a telegram response. You can read how to interpret this data from the official P1 companion standard from Netbeheer Nederland.


/ISK5\\\\2M550T-10111-

3:0.2.8(50)
0-0:1.0.0(181106140429W)
0-0:96.1.1(31333631353032362020202020202020)
1-0:1.8.1(10830.511*kWh)
1-0:1.8.2(002948.827*kWh)
1-0:2.8.1(001285.951*kWh)
1-0:2.8.2(002876.514*kWh)
0-0:96.14.0(0002)
1-0:1.7.0(21.100*kW)
1-0:2.7.0(00.000*kW)
0-0:96.7.21(00006)
0-0:96.7.9(00003)
1-0:99.97.0(1)(0-0:96.7.19)(180529135630S)(0000002451*s)
1-0:32.32.0(00003)
1-0:52.32.0(00002)
1-0:72.32.0(00002)
1-0:32.36.0(00001)
1-0:52.36.0(00001)
1-0:72.36.0(00001)
0-0:96.13.0()
1-0:32.7.0(236.0*V)
1-0:52.7.0(232.6*V)
1-0:72.7.0(235.1*V)
1-0:31.7.0(002*A)
1-0:51.7.0(000*A)
1-0:71.7.0(000*A)
1-0:21.7.0(00.000*kW)
1-0:41.7.0(00.033*kW)
1-0:61.7.0(00.132*kW)
1-0:22.7.0(00.676*kW)
1-0:42.7.0(00.000*kW)
1-0:62.7.0(00.000*kW)
0-1:24.1.0(003)
0-1:96.1.0(4730303339303031373030343630313137)
0-1:24.2.1(210606140010W)(02569.646*m3)
!1F28