Get historical data of a spa
<p><strong>A brief description:</strong> </p>
<p>-Interface to get historical data of a spa
-<code>Only applicable to devices whose device type is 6 returned in the 3.3 interface.</code></p>
<p><strong>Request URL:</strong>
-<code>http(s)://test.growatt.com/v1/device/spa/spa_data</code></p>
<p><strong>How to request:</strong>
-post</p>
<p><strong>Parameter:</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">Parameter name</th>
<th style="text-align: left;">Is it required</th>
<th style="text-align: left;">Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">spa_sn</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">String</td>
<td>Spa Equipment SN</td>
</tr>
<tr>
<td style="text-align: left;">start_date</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">String</td>
<td>start date</td>
</tr>
<tr>
<td style="text-align: left;">end_date</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">String</td>
<td>end date (the date interval cannot exceed 7 days)</td>
</tr>
<tr>
<td style="text-align: left;">timezone_id</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">int</td>
<td>The time zone code of the data display</td>
</tr>
<tr>
<td style="text-align: left;">perpage</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">int</td>
<td>Number per page, default 20, maximum 100</td>
</tr>
<tr>
<td style="text-align: left;">page</td>
<td style="text-align: left;">No</td>
<td style="text-align: left;">int</td>
<td>Number of pages</td>
</tr>
</tbody>
</table>
<p><strong>Return example</strong></p>
<pre><code>{
"data": {
"datas": [
{
"etogridTotal": 104.7,
"vBus2": 283,
"bmsCell1Volt": 0,
"faultBitCode": -1,
"eacToday": 5.099999904632568,
"socText": "88%",
"bmsMaxCurr": 0,
"vBus1": 378,
"errorText": "Unknown",
"vBatDsp": 51.400001525878906,
"time": "2018-12-19 16:03:04",
"upsVac1": 0,
"bmsStatusOld": 0,
"bmsPackInfo": 0,
"bmsGaugeRM": 0,
"bmsCell2Volt": 0,
"bmsCycleCnt": 0,
"pacToUserR": 0,
"acChargeEnergyToday": 0,
"again": false,
"bmsCell14Volt": 0,
"bmsUsingCap": 0,
"bmsCell12Volt": 0,
"soc": 88,
"epvInverterToday": 0.6,
"echarge1Today": 0,
"batteryTemperature": 26.299999237060547,
"bmsCell3Volt": 0,
"bmsCell13Volt": 0,
"plocalLoadR": 2946.4,
"upsFac": 0,
"bmsCell7Volt": 0,
"timeTotal": -0.5,
"bmsCell10Volt": 0,
"bmsGaugeFCC": 0,
"etoUserToday": 0,
"pcharge1": 0,
"sysFaultWord": 0,
"bmsCell5Volt": 0,
"dataLogSn": "",
"bmsError": 0,
"vbat": 51.400001525878906,
"uwSysWorkMode": 6,
"elocalLoadToday": 5.6,
"bmsCell9Volt": 0,
"bmsCell6Volt": 0,
"bmsFW": 0,
"bmsStatus": 0,
"acChargePower": 0,
"plocalLoadTotal": 0,
"bmsCell15Volt": 0,
"acChargeEnergyTotal": 35.900001525878906,
"bmsErrorOld": 0,
"bmsCell4Volt": 0,
"pac1": 2976.6,
"errorCode": -1,
"bmsBatteryCurr": 0,
"bmsMCUVersion": 0,
"epvInverterTotal": 0.6,
"etoUserTotal": 104.8,
"priorityChoose": 2,
"warnCode": -1,
"bmsDeltaVolt": 0,
"serialNum": "LHD0847002",
"pacToUserTotal": 0,
"sysFaultWord2": 0,
"dayMap": null,
"sysFaultWord1": 0,
"vac1": 230.6999969482422,
"bmsWarnInfoOld": 0,
"sysFaultWord6": 0,
"bmsCell16Volt": 0,
"edischarge1Today": 6,
"status": 6,
"sysEn": -1,
"sysFaultWord5": 0,
"sysFaultWord4": 0,
"sysFaultWord3": 0,
"ppvInverter": 6.8,
"sysFaultWord7": 256,
"elocalLoadTotal": 77.9,
"upsLoadpercent": 0,
"upsPF": 1000,
"fac": 50.02000045776367,
"day": "",
"faultCode": -1,
"bmsBatteryVolt": 0,
"eacTotal": 156.6,
"lost": true,
"pacToGridR": 9.4,
"statusText": "Bat Online",
"bmsWarnInfo": 0,
"bmsBatteryTemp": 0,
"warnText": "Unknown",
"upsPac1": 0,
"bmsSOH": 0,
"temp1": 72,
"temp2": 40,
"withTime": false,
"bmsCell8Volt": 0,
"bmsCell11Volt": 0,
"calendar": {
"minimalDaysInFirstWeek": 1,
"time": {
"time": 1545206584000,
"minutes": 3,
"seconds": 4,
"hours": 16,
"month": 11,
"timezoneOffset": -480,
"year": 118,
"day": 3,
"date": 19
},
"weekYear": 2018,
"weeksInWeekYear": 52,
"gregorianChange": {
"time": -12219292800000,
"minutes": 0,
"seconds": 0,
"hours": 8,
"month": 9,
"timezoneOffset": -480,
"year": -318,
"day": 5,"date": 15
},
"timeZone": {
"lastRuleInstance": null,
"DSTSavings": 0,
"rawOffset": 28800000,
"ID": "Asia/Shanghai",
"dirty": false,
"displayName": "China Standard Time"
},
"lenient": true,
"timeInMillis": 1545206584000,
"firstDayOfWeek": 1,
"weekDateSupported": true
},
"spaBean": null,
"pac": 2976.3,
"edischarge1Total": 167.1,
"alias": "",
"batteryType": 0,
"bmsSOC": 0,
"etoGridToday": 0.2,
"pdischarge1": 3083,
"bmsInfo": 0,
"pacToGridTotal": 9.4,
"address": 0,
"bmsConstantVolt": 0,
"bmsMaxDischgCurr": 0,
"echarge1Total": 32.9
}
],
"spa_sn": "LHD0847002",
"next_page_start_id": 21,
"count": 3662,
"datalogger_sn": "JPC2827188"
},
"error_code": 0,
"error_msg": ""
}</code></pre>
<p><strong>Return parameter description</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">Type</th>
<th style="text-align: left;">Parameter name</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">String</td>
<td style="text-align: left;">serialNum</td>
<td>Serial Number</td>
</tr>
<tr>
<td style="text-align: left;">Calendar</td>
<td style="text-align: left;">calendar</td>
<td>Time</td>
</tr>
<tr>
<td style="text-align: left;">boolean</td>
<td style="text-align: left;">withTime</td>
<td>Does the sent data contain time?</td>
</tr>
<tr>
<td style="text-align: left;">boolean</td>
<td style="text-align: left;">isAgain</td>
<td>Whether to continue</td>
</tr>
<tr>
<td style="text-align: left;">boolean</td>
<td style="text-align: left;">lost = true</td>
<td>Whether communication is lost</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">pac</td>
<td>Inverter output power</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">fac</td>
<td>grid frequency</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">vac1</td>
<td>Grid voltage</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">pac1</td>
<td>Inverter output apparent power</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">eacToday</td>
<td>Inverter daily output power</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">eacTotal</td>
<td>Inverter total output power</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">timeTotal</td>
<td>Total running time</td>
</tr>
<tr>
<td style="text-align: left;">int</td>
<td style="text-align: left;">faultCode</td>
<td>Inverter fault code</td>
</tr>
<tr>
<td style="text-align: left;">int</td>
<td style="text-align: left;">faultBitCode</td>
<td>Inverter fault code</td>
</tr>
<tr>
<td style="text-align: left;">int</td>
<td style="text-align: left;">warnCode</td>
<td>warning code</td>
</tr>
<tr>
<td style="text-align: left;">int</td>
<td style="text-align: left;">errorCode</td>
<td>error code</td>
</tr>
<tr>
<td style="text-align: left;">int</td>
<td style="text-align: left;">uwSysWorkMode</td>
<td>System working mode</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">pdischarge1</td>
<td>Battery discharge power</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">pcharge1</td>
<td>Battery charging power</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">vbat</td>
<td>battery voltage</td>
</tr>
<tr>
<td style="text-align: left;">int</td>
<td style="text-align: left;">soc</td>
<td>remaining battery capacity</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">pacToUserR</td>
<td>Grid downstream power</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">pacToUserTotal</td>
<td>Total downstream power of the grid</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">pacToGridR</td>
<td>Grid countercurrent power</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">pacToGridTotal</td>
<td>Total grid countercurrent power</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">plocalLoadR</td>
<td>Local load power consumption</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">plocalLoadTotal</td>
<td>Total local load power consumption</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">batteryTemperature</td>
<td>battery temperature</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">etoUserToday</td>
<td>Grid Sunrise Electricity</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">etoUserTotal</td>
<td>Total grid output</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">etoGridToday</td>
<td>Daily grid electricity</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">etogridTotal</td>
<td>Total grid power</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">edischarge1Today</td>
<td>Daily battery discharge</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">edischarge1Total</td>
<td>Total battery discharge</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">echarge1Today</td>
<td>Daily battery charge</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">echarge1Total</td>
<td>Total battery charge</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">elocalLoadToday</td>
<td>Daily power consumption of local load</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">elocalLoadTotal</td>
<td>Total local load power consumption</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">upsFac</td>
<td>Emergency power frequency</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">upsVac1</td>
<td>Emergency voltage</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">upsPac1</td>
<td>Emergency output apparent power</td>
</tr>
<tr>
<td style="text-align: left;">int</td>
<td style="text-align: left;">upsLoadpercent</td>
<td>Emergency output load rate</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">upsPF</td>
<td>Emergency output power factor</td>
</tr>
<tr>
<td style="text-align: left;">int</td>
<td style="text-align: left;">bmsStatusOld</td>
<td>Battery history status</td>
</tr>
<tr>
<td style="text-align: left;">int</td>
<td style="text-align: left;">bmsStatus</td>
<td>Battery status</td>
</tr>
<tr>
<td style="text-align: left;">int</td>
<td style="text-align: left;">bmsErrorOld</td>
<td>Battery history failure</td>
</tr>
<tr>
<td style="text-align: left;">int</td>
<td style="text-align: left;">bmsError</td>
<td>Battery failure</td>
</tr>
<tr>
<td style="text-align: left;">int</td>
<td style="text-align: left;">bmsSOC</td>
<td>Battery remaining capacity</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">bmsBatteryVolt</td>
<td>Battery voltage</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">bmsBatteryCurr</td>
<td>Battery current</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">bmsBatteryTemp</td>
<td>Battery temperature</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">bmsMaxCurr</td>
<td>Maximum charge and discharge current</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">bmsMaxDischgCurr</td>
<td>Maximum discharge current</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">bmsGaugeRM</td>
<td>System Capacity</td>
</tr>
<tr>
<td style="text-align: left;">int</td>
<td style="text-align: left;">bmsGaugeFCC</td>
<td>Rated capacity</td>
</tr>
<tr>
<td style="text-align: left;">int</td>
<td style="text-align: left;">bmsFW</td>
<td>BMS firmware version number</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">bmsDeltaVolt</td>
<td>Differential pressure between battery cells</td>
</tr>
<tr>
<td style="text-align: left;">int</td>
<td style="text-align: left;">bmsCycleCnt</td>
<td>Number of battery cycles</td>
</tr>
<tr>
<td style="text-align: left;">int</td>
<td style="text-align: left;">bmsSOH</td>
<td>Battery health status</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">bmsConstantVolt</td>
<td>Battery charging constant voltage point</td>
</tr>
<tr>
<td style="text-align: left;">int</td>
<td style="text-align: left;">bmsWarnInfoOld</td>
<td>Battery historical warning information</td>
</tr>
<tr>
<td style="text-align: left;">int</td>
<td style="text-align: left;">bmsWarnInfo</td>
<td>Battery warning information</td>
</tr>
<tr>
<td style="text-align: left;">int</td>
<td style="text-align: left;">bmsMCUVersion</td>
<td>BMS firmware version</td>
</tr>
<tr>
<td style="text-align: left;">int</td>
<td style="text-align: left;">bmsInfo</td>
<td>BMS Information</td>
</tr>
<tr>
<td style="text-align: left;">int</td>
<td style="text-align: left;">bmsPackInfo</td>
<td>Battery pack information</td>
</tr>
<tr>
<td style="text-align: left;">int</td>
<td style="text-align: left;">bmsUsingCap</td>
<td>Battery pack power type</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">bmsCell1Volt</td>
<td>Battery single cell 1 voltage</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">bmsCell2Volt</td>
<td>Battery single cell 2 voltage</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">bmsCell3Volt</td>
<td>Battery single cell 3 voltage</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">bmsCell4Volt</td>
<td>Battery single cell 4 voltage</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">bmsCell5Volt</td>
<td>Battery single cell 5 voltage</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">bmsCell6Volt</td>
<td>battery single cell 6 voltage</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">bmsCell7Volt</td>
<td>Battery single cell 7 voltage</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">bmsCell8Volt</td>
<td>Battery single cell 8 voltage</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">bmsCell9Volt</td>
<td>Battery single cell 9 voltage</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">bmsCell10Volt</td>
<td>Battery single cell 10 voltage</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">bmsCell11Volt</td>
<td>Battery single cell 11 voltage</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">bmsCell12Volt</td>
<td>Battery single cell 12 voltage</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">bmsCell13Volt</td>
<td>battery single cell 13 voltage</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">bmsCell14Volt</td>
<td>Battery single cell 14 voltage</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">bmsCell15Volt</td>
<td>battery single cell 15 voltage</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">bmsCell16Volt</td>
<td>Battery single cell 16 voltage</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">acChargeEnergyToday</td>
<td>AC daily charge</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">acChargeEnergyTotal</td>
<td>AC total charge</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">acChargePower</td>
<td>AC charging power</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">vBus1</td>
<td>Bus1 voltage</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">vBus2</td>
<td>Bus2 voltage</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">temp1</td>
<td>temperature 1</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">temp2</td>
<td>temperature 2</td>
</tr>
<tr>
<td style="text-align: left;">float</td>
<td style="text-align: left;">vBatDsp</td>
<td>Battery voltage collected by DSP</td>
</tr>
<tr>
<td style="text-align: left;">int</td>
<td style="text-align: left;">sysEn</td>
<td>System enable bit</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">epvInverterToday</td>
<td>Daily electricity generated by photovoltaic inverter</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">epvInverterTotal</td>
<td>Accumulated electricity generated by photovoltaic inverter</td>
</tr>
<tr>
<td style="text-align: left;">double</td>
<td style="text-align: left;">ppvInverter</td>
<td>Photovoltaic inverter power generation</td>
</tr>
<tr>
<td style="text-align: left;">error_code</td>
<td style="text-align: left;">string</td>
<td>0: Normal return, 10001: System error, 10002: Device serial number error, 10003: Date format error, 10004: Date interval exceeds seven days, 10005: Spa does not exist</td>
</tr>
<tr>
<td style="text-align: left;">error_msg</td>
<td style="text-align: left;">string</td>
<td>Error message prompt</td>
</tr>
</tbody>
</table>
<p><strong>Remarks</strong>
-The frequency of acquisition is once every 10 seconds</p>