Batch data for one day
<p><strong>Brief Description:</strong></p>
<ul>
<li>Retrieve all detailed data for a specific day from a list of devices based on their SNs, device type, and date. The data returned by the API will only include information for devices that the secret token has permission to access. Devices without permission will not have their data returned.</li>
<li><code>The device type is the deviceType parameter from the Get Device List API.</code></li>
</ul>
<p><strong>Request URL:</strong></p>
<ul>
<li><code>https://openapi.growatt.com/v4/new-api/queryDevicesHistoricalData</code></li>
</ul>
<p><strong>Request Method:</strong></p>
<ul>
<li>POST</li>
</ul>
<p><strong>Content-Type:</strong></p>
<ul>
<li>application/x-www-form-urlencoded</li>
</ul>
<p><strong>HTTP Header Parameters and Description:</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">Parameter Name</th>
<th style="text-align: left;">Required</th>
<th style="text-align: left;">Type</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">token</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">Secret token</td>
</tr>
</tbody>
</table>
<p><strong>HTTP Body Parameters and Description:</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">Parameter Name</th>
<th style="text-align: left;">Required</th>
<th style="text-align: left;">Type</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">deviceSn</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">Array of inverter serial numbers (SN), up to 50. Device serial numbers should be separated by commas. Example: xxxx,xxxxx,xxxx (maximum of 50)</td>
</tr>
<tr>
<td style="text-align: left;">deviceType</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">[Device Type](<a href="https://www.showdoc.com.cn/p/b42ee029e131c68c4dbfdd89285c0ec1">https://www.showdoc.com.cn/p/b42ee029e131c68c4dbfdd89285c0ec1</a> "Device Type")</td>
</tr>
<tr>
<td style="text-align: left;">date</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">Start date (format: yyyy-mm-dd). Example: 2024-05-14</td>
</tr>
</tbody>
</table>
<p><strong>Call Example</strong></p>
<pre><code>{
&quot;deviceSn&quot;: &quot;FDCJQ00003,FDCJQ00002&quot;,
&quot;deviceType&quot;: &quot;min&quot;,
&quot;date&quot;: &quot;2024-05-14&quot;
}</code></pre>
<p><strong>Return Example</strong></p>
<p>inv: <a href="https://www.showdoc.com.cn/2540838290984246/11292917584269311">https://www.showdoc.com.cn/2540838290984246/11292917584269311</a>
storage: <a href="https://www.showdoc.com.cn/2540838290984246/11292918959841019">https://www.showdoc.com.cn/2540838290984246/11292918959841019</a>
sph: <a href="https://www.showdoc.com.cn/2540838290984246/11292922712705121">https://www.showdoc.com.cn/2540838290984246/11292922712705121</a>
max: <a href="https://www.showdoc.com.cn/2540838290984246/11292920771207078">https://www.showdoc.com.cn/2540838290984246/11292920771207078</a>
spa: <a href="https://www.showdoc.com.cn/2540838290984246/11292925068299407">https://www.showdoc.com.cn/2540838290984246/11292925068299407</a>
min: <a href="https://www.showdoc.com.cn/2540838290984246/11292926895869382">https://www.showdoc.com.cn/2540838290984246/11292926895869382</a>
wit: <a href="https://www.showdoc.com.cn/2540838290984246/11292928841081078">https://www.showdoc.com.cn/2540838290984246/11292928841081078</a>
sph-s: <a href="https://www.showdoc.com.cn/2540838290984246/11292930141133325">https://www.showdoc.com.cn/2540838290984246/11292930141133325</a>
noah：<a href="https://www.showdoc.com.cn/2540838290984246/11315142054122408">https://www.showdoc.com.cn/2540838290984246/11315142054122408</a></p>
<p><strong>Remarks</strong></p>
<ul>
<li>The retrieval frequency is once every 5 minutes or less.</li>
</ul>