Example Asset Responses
The equipment returned by the /sites endpoint is ’flat’. Meaning that it is organized by device type, not listed as a full hierarchy.
This is because, all devices are part of one ‘system’ with Gateways being the ‘parent’ and all batteries, inverters and meters being the children. Since there is an expectation of only a single Gateway on a site, it is implied that all devices are children of the Gateway reported.
The following example response is for a Powerwall+. Note that the asset data for this device type reports a separate battery and inverter. The inverter block refers to the solar inverter integrated in a Powerwall+. If it were a Powerwall 2, the inverter block would simple be omitted, because Powerwall 2 does not have an integrated solar inverter.
{
"data": {
"site_id": "155b4f6e-a39b-4c5e-af59-dfb547538887",
"site_name": "STE20240105-00008",
"created_datetime": "2024-01-05T00:07:06.671Z",
"updated_datetime": "2024-01-05T00:07:06.759Z",
"aggregator_site_identifier": null,
"battery": {
"total_nameplate_max_discharge_power": 5800,
"total_nameplate_max_charge_power": 5800,
"total_nameplate_energy": 13500,
"batteries": [
{
"din": "3012170-25-E--TG123149001MB6",
"part_number": "3012170-25-E",
"serial_number": "TG123149001MB6"
}
]
},
"gateway": {
"total_gateways": 1,
"gateways": [
{
"device_id": "f6a6c145-0a68-456c-96ef-8860ae110386",
"din": "1538000-25-H--GF2232290002MP",
"part_number": "1538000-25-H",
"serial_number": "GF2232290002MP"
}
]
},
"inverter": [
{
"din": "1538100-01-F--ADU23199G000LJ",
"part_number": "1538100-01-F",
"serial_number": "ADU23199G000LJ"
}
],
"meter": [
{
"din": "NEURIO--VAH5121AB5783",
"part_number": "NEURIO",
"serial_number": "VAH5121AB5783"
}
]
}
}Larger Powerwall systems follow the same convention. A Powerwall 2 is represented the same as a Powerwall + battery assembly (without the solar inverter). The following example response contains two Powerwall+’s and one Powerwall 2.
{
"data": {
"site_id": "9340c60a-6422-4f81-839b-b248a9fd4953",
"site_name": "STE20240104-01114",
"created_datetime": "2024-01-04T22:17:28.174Z",
"updated_datetime": "2024-01-04T22:24:48.431Z",
"aggregator_site_identifier": null,
"battery": {
"total_nameplate_max_discharge_power": 16600,
"total_nameplate_max_charge_power": 16600,
"total_nameplate_energy": 40500,
"batteries": [
{
"din": "3012170-05-E--TG123194002SBL",
"part_number": "3012170-05-E",
"serial_number": "TG123194002SBL"
},
{
"din": "3012170-25-E--TG123087000LT7",
"part_number": "3012170-25-E",
"serial_number": "TG123087000LT7"
},
{
"din": "3012170-25-E--TG12324900351T",
"part_number": "3012170-25-E",
"serial_number": "TG12324900351T"
}
]
},
"gateway": {
"total_gateways": 1,
"gateways": [
{
"device_id": "1804a9e5-45a8-4623-9d8b-dc86ca2cfc86",
"din": "1538000-25-F--GF223148000281",
"part_number": "1538000-25-F",
"serial_number": "GF223148000281"
}
]
},
"inverter": [
{
"din": "1538100-01-F--CN322234C1F06A",
"part_number": "1538100-01-F",
"serial_number": "CN322234C1F06A"
},
{
"din": "1538100-01-F--ADU22276J0002A",
"part_number": "1538100-01-F",
"serial_number": "ADU22276J0002A"
}
],
"meter": [
{
"din": "NEURIO--VAH5384AB2492",
"part_number": "NEURIO",
"serial_number": "VAH5384AB2492"
},
{
"din": "NEURIO--VAH5348AB1911",
"part_number": "NEURIO",
"serial_number": "VAH5348AB1911"
}
]
}
}
If a site has a stand-alone Tesla Solar inverter, not part of a Powerwall+, it is treated as a stand-alone product. This is reported in the asset response as an inverter but should be treated as a separate device since all telemetry is sent directly to Tesla cloud platform and not routed through the Gateway.
This is why the Tesla Solar inverter requires separate registration during commissioning and will be a distinct target for telemetry requests.
The distinction between a Powerwall+ solar assembly and a Tesla Solar inverter can be made from the part number (1538000-45) being distinct to a Tesla Solar Inverter.
The Powerwall system will capture a small subset (Power/Energy) of Tesla Inverter data via the current transformers as this is needed for system operation. The following example response contains 1 x Powerwall +, 1 x Powerwall 2 and 1 x Solar Inverter.
{
"data": {
"site_id": "9340c60a-6422-4f81-839b-b248a9fd4953",
"site_name": "STE20240104-01114",
"created_datetime": "2024-01-04T22:17:28.174Z",
"updated_datetime": "2024-01-04T22:24:48.431Z",
"aggregator_site_identifier": null,
"battery": {
"total_nameplate_max_discharge_power": 16600,
"total_nameplate_max_charge_power": 16600,
"total_nameplate_energy": 40500,
"batteries": [
{
"din": "3012170-05-E--TG123194002SBL",
"part_number": "3012170-05-E",
"serial_number": "TG123194002SBL"
},
{
"din": "3012170-25-E--TG12324900351T",
"part_number": "3012170-25-E",
"serial_number": "TG12324900351T"
}
]
},
"gateway": {
"total_gateways": 1,
"gateways": [
{
"device_id": "1804a9e5-45a8-4623-9d8b-dc86ca2cfc86",
"din": "1538000-25-F--GF223148000281",
"part_number": "1538000-25-F",
"serial_number": "GF223148000281"
}
]
},
"inverter": [
{
"din": "1538100-01-F--CN322234C1F06A",
"part_number": "1538100-01-F",
"serial_number": "CN322234C1F06A"
},
{
"din": "1538000-45-F--ADU22276J00XYZ",
"part_number": "1538000-45-F",
"serial_number": "ADU22276J00XYZ"
}
],
"meter": [
{
"din": "NEURIO--VAH5384AB2492",
"part_number": "NEURIO",
"serial_number": "VAH5384AB2492"
},
{
"din": "NEURIO--VAH5348AB1911",
"part_number": "NEURIO",
"serial_number": "VAH5348AB1911"
}
]
}
}
Below is an example response for a Powerwall 3. Note that it displays all the relevant information in the “gateways” block. This is because the Powerwall 3 has an integrated site controller.
{
"data": {
"site_id": "83811f10-c279-4fa7-a39c-b3880edf1179",
"site_name": "STE20230221-00414",
"created_datetime": "2023-02-21T21:08:02.913Z",
"updated_datetime": "2023-10-29T00:39:14.946Z",
"aggregator_site_identifier": null,
"battery": {
"total_nameplate_max_discharge_power": 0,
"total_nameplate_max_charge_power": 0,
"total_nameplate_energy": 0,
"batteries": []
},
"gateway": {
"total_gateways": 1,
"gateways": [
{
"device_id": "8c638dd7-4700-429e-a7e7-03d74059e43d",
"din": "1707000-00-G--TG123084003G9W",
"part_number": "1707000-00-G",
"serial_number": "TG123084003G9W"
}
]
},
"inverter": [],
"meter": []
}
}