Device List
<p><strong>Brief Description:</strong></p>
<ul>
<li>Retrieve the list of devices associated with the distributor, installer, and terminal account of the secret token. The devices obtained through this interface are the only ones allowed to fetch data from; devices not on the list are not permitted to retrieve data.</li>
</ul>
<p><strong>Request URL:</strong></p>
<ul>
<li><code>https://openapi.growatt.com/v4/new-api/queryDeviceList</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;">page</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">Page number, default 1 (1~n)</td>
</tr>
</tbody>
</table>
<p><strong>Example Call</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;">Value</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">page</td>
<td style="text-align: left;">Yes</td>
<td style="text-align: left;">1</td>
<td style="text-align: left;">Page number, default 1</td>
</tr>
</tbody>
</table>
<p><strong>Example Response</strong></p>
<pre><code>{
&quot;code&quot;: 0,
&quot;data&quot;: {
&quot;pages&quot;: 1,
&quot;pageSize&quot;: 100,
&quot;count&quot;: 7,
&quot;other&quot;: null,
&quot;notPager&quot;: false,
&quot;data&quot;: [
{
&quot;deviceType&quot;: &quot;max&quot;,
&quot;deviceSn&quot;: &quot;HPJ0BF20FU&quot;,
&quot;createDate&quot;: &quot;2021-06-29 12:02:46.0&quot;
},
{
&quot;deviceType&quot;: &quot;inv&quot;,
&quot;deviceSn&quot;: &quot;AEC1733378&quot;,
&quot;createDate&quot;: &quot;2018-11-10 16:42:59.0&quot;
},
{
&quot;deviceType&quot;: &quot;inv&quot;,
&quot;deviceSn&quot;: &quot;CI04010115&quot;,
&quot;createDate&quot;: &quot;2019-12-19 21:38:38.0&quot;
},
{
&quot;deviceType&quot;: &quot;inv&quot;,
&quot;deviceSn&quot;: &quot;AEC173337D&quot;,
&quot;createDate&quot;: &quot;2019-04-03 10:55:21.0&quot;
},
{
&quot;deviceType&quot;: &quot;inv&quot;,
&quot;deviceSn&quot;: &quot;BX30911324&quot;,
&quot;createDate&quot;: &quot;2020-07-09 11:01:04.0&quot;
},
{
&quot;deviceType&quot;: &quot;inv&quot;,
&quot;deviceSn&quot;: &quot;PT44390040&quot;,
&quot;createDate&quot;: &quot;2020-07-09 10:50:55.0&quot;
},
{
&quot;deviceType&quot;: &quot;inv&quot;,
&quot;deviceSn&quot;: &quot;PR34211399&quot;,
&quot;createDate&quot;: &quot;2017-01-18 14:09:53.0&quot;
}
],
&quot;lastPager&quot;: true,
&quot;startCount&quot;: 0
},
&quot;message&quot;: &quot;SUCCESSFUL_OPERATION&quot;
}</code></pre>
<p><strong>Response Parameters Description</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">Parameter Name</th>
<th style="text-align: left;">Type</th>
<th style="text-align: left;">Description</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">deviceType</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;">count</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Device Count</td>
</tr>
<tr>
<td style="text-align: left;">deviceSn</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Device Serial Number</td>
</tr>
<tr>
<td style="text-align: left;">datalogSn</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Collector Serial Number</td>
</tr>
<tr>
<td style="text-align: left;">createDate</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">Date Added</td>
</tr>
</tbody>
</table>
<p><strong>Remarks</strong></p>
<ul>
<li>Fetch frequency is limited to once every 5 seconds.</li>
</ul>