InControl 2 API
The InControl 2 API opens up a world of possibilities for integrating our platform with your custom apps, web site, or other third party software.
PEPLINK INCONTROL API LICENSE AGREEMENT
AND
TERMS OF USE
You have no rights with respect to the API or any portion thereof and shall not use the API or any portion thereof except as expressly set forth herein. Without limiting the generality of the foregoing, You agree not to (i) modify or create derivative works of the API; (ii) sublicense, lease, rent, assign, distribute, repackage, rebrand, or otherwise transfer or disclose the API, any portion thereof or any documentation to any third party; (iii) use the API on or in connection with any application other than Peplink InControl; or (iv) cause, assist or permit any third party (including an end-user) to do any of the foregoing.
use the API for any illegal or unauthorized purpose;
remove or alter any copyright, trademark or other proprietary rights notices contained in the API or any other Peplink content, including but not limited to maps and/or driving directions;
submit content that falsely expresses or implies that such content is sponsored or endorsed by Peplink; or
transmit any viruses, worms, defects, Trojan horses, or any items of a destructive nature.
YOUR USE OF THE API IS AT YOUR SOLE RISK. THE API IS PROVIDED ON AN "AS IS" AND "AS AVAILABLE" BASIS. PEPLINK EXPRESSLY DISCLAIMS ALL WARRANTIES OF ANY KIND, WHETHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
YOU EXPRESSLY UNDERSTAND AND AGREE THAT IN NO EVENT Peplink SHALL BE LIABLE TO YOU FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, EXEMPLARY, OR ANY OTHER DAMAGES, INCLUDING BUT NOT LIMITED TO, DAMAGES FOR LOSS OF PROFITS, GOODWILL, USE, DATA OR OTHER INTANGIBLE LOSSES (EVEN IF PEPLINK HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES), RESULTING FROM: (i) THE USE OR THE INABILITY TO USE THE API; (ii) UNAUTHORIZED ACCESS TO OR ALTERATION OF YOUR TRANSMISSIONS OR DATA; OR (iii) ANY OTHER MATTER RELATING TO THE API. Some jurisdictions do not allow the exclusion of certain warranties or the limitation or exclusion of liability for incidental or consequential damages. Accordingly, some of the above limitations of clauses 7 and 8 may not apply to you.
You agree to indemnify and hold harmless Peplink, and its subsidiaries, affiliates, officers, agents, and employees, advertisers, licensors, and partners, from and against any third party claim arising from or in any way related to your use of the API, violation of these Terms of Use or any other actions connected with use of any Peplink Applications, including any liability or expense arising from all claims, losses, damages (actual and consequential), suits, judgments, litigation costs and attorneys' fees, of every kind and nature. In such a case, Peplink will provide You with written notice of such claim, suit or action.
"Intellectual Property Rights" shall mean any and all rights existing under patent law, copyright law, semiconductor chip protection law, moral rights law, trade secret law, trademark law, unfair competition law, publicity rights law, privacy rights law, and any and all other proprietary rights, and any and all applications, renewals, extensions and restorations thereof, now or hereafter in force and effect worldwide. As between You and Peplink, You acknowledge that Peplink owns all right, title and interest, including without limitation all Intellectual Property Rights, in and to the API, including but not limited to the API and any mapping data accessed by virtue of the API, and that You shall not acquire any right, title, or interest in or to the API, except the limited license expressly set forth in the Terms of Use. You agree that You shall not disclose anything related, directly or indirectly, about the API to any third parties. You further acknowledge that You will only disclose the API to your colleagues on "need-to-know" basis.
Term. The term of the Terms of Use shall commence on the date upon which You agree to the Terms of Use and shall continue in force thereafter, unless terminated as provided herein.
I agree to comply with the above Peplink InControl API License Agreement And Terms Of Use
Introduction
InControl 2 API uses the OAuth 2.0 protocol for authentication and authorization. It supports common OAuth 2.0 scenarios such as those for web server, installed, and client-side applications.
To begin, you will have to obtain an OAuth 2.0 client ID. If your app will access your InControl account only, you could get an ID by clicking on your username on the top of your InControl screen and scrolling down to the section "Client Application". If your app will allow any InControl users to sign-in and access their data, you can obtain an ID by sending an e-mail with your company name, company URL, app name, and redirect URI prefix to ic2api@peplink.com.
After you obtained a client ID, your client application should use it to request an authorization token from our authorization endpoints. Then it should request and extract an access token from the response from our token endpoint, and send the token to the InControl 2.0 API.
For more details about the OAuth 2.0, please refer to the RFC 6749.
You may also click the Get Access Token button below to obtain an access token and experiment the API below.
Unless specified, all timestamps returned from the API are also in the corresponding group's time zone.
Authorization Endpoint:
Token Endpoint:
Access Token Location:
Token Response:
Usage Example:
Refresh token:
API Request Rate Limit
The API request rate limit is 20 requests per second per organization for the public InControl. No limit for InControl Appliance.
A "429" response code will be returned if the rate limit is reached.
API Error Responses
OpenAPI specification
The OpenAPI specification can be found in HERE
Sample shell script implementation
A sample script can be downloaded from HERE
Obtain token using "client_credentials" flow example [show]
InControl 2 API uses the OAuth 2.0 protocol for authentication and authorization. It supports common OAuth 2.0 scenarios such as those for web server, installed, and client-side applications.
To begin, you will have to obtain an OAuth 2.0 client ID. If your app will access your InControl account only, you could get an ID by clicking on your username on the top of your InControl screen and scrolling down to the section "Client Application". If your app will allow any InControl users to sign-in and access their data, you can obtain an ID by sending an e-mail with your company name, company URL, app name, and redirect URI prefix to ic2api@peplink.com.
After you obtained a client ID, your client application should use it to request an authorization token from our authorization endpoints. Then it should request and extract an access token from the response from our token endpoint, and send the token to the InControl 2.0 API.
For more details about the OAuth 2.0, please refer to the RFC 6749.
You may also click the Get Access Token button below to obtain an access token and experiment the API below.
Unless specified, all timestamps returned from the API are also in the corresponding group's time zone.
- https://api.ic.peplink.com/api/oauth2/auth?client_id=[CLIENT_ID]&response_type=[code/token]&redirect_uri=[REDIRECT_URI]
- https://api.ic.peplink.com/api/oauth2/token
- Required Parameters: client_id, client_secret, grant_type, redirect_uri, code
- Method: POST
- Form Encode: application/x-www-form-urlencoded
- Authorization header with 'Bearer' prefix [OR]
- 'access_token' URL parameter
- Content-Type: application/json
- {"access_token":"your_access_token", "expires_in": 172799, "token_type":"Bearer", "refresh_token":"your_refresh_token"}
- access_token: The access token string for API call.
- expires_in: Duration of time in seconds the access token is granted for, default: 2 days.
- token_type: Type of token
- refresh_token: When access token expires, you may renew the access token through the OAuth "refresh_token" flow.
By default, the refresh_token expires 30 days after the access token expires.
- Obtain Accessible organization list: https://api.ic.peplink.com/rest/o?access_token=[ACCESS_TOKEN]
- Obtain group list: https://api.ic.peplink.com/rest/o/abcdef/g?access_token=[ACCESS_TOKEN]
- https://api.ic.peplink.com/api/oauth2/token
- Method: POST
- Encoding: application/x-www-form-urlencoded
- Data: client_id=[your_client_id]&client_secret=[your_client_secret]&grant_type=refresh_token&refresh_token=[your_refresh_token]
API Request Rate Limit
A "429" response code will be returned if the rate limit is reached.
API Error Responses
- When the access token expired or invalid
- Response code: 401
- {"error": "invalid_accessor","error_description":"Error message here"}
- When the access token reach rate limit
- Response code: 429
- {"error": "rate_limit_exceeded","error_description":"Error message here"}
- When the request is unauthorized
- Response code: 401
- {"error": "unauthorized","error_description":"Error message here"}
- When the organization_id is invalid
- Response code: 404
- {"error": "org_not_found","error_description":"Error message here"}
OpenAPI specification
The OpenAPI specification can be found in HERE
Sample shell script implementation
Obtain token using "client_credentials" flow example [show]
OAuth has different grant type, depends on the your application needs, to obtain the access token with client ID and client secret, you may grant access thru the "client_credentials" flow, for detail information regarding OAuth, please refer to below URL.
https://www.digitalocean.com/community/tutorials/an-introduction-to-oauth-2
Create RESTful API client
1) Login to InControl2
2) In any organization/network/device overview, on the top right hand corner, click on your login email address before the "Sign out" link, that would bring you to account setting page.
3) At the bottom of the page, there is a "Client Application" section, click on "New Client"
4) Enter the name and checked "Enable", other fields can be leave blank, then click "Save"
5) Click on the application name that you just created, you should see "Client ID" and "Client Secret" at the bottom of the popup window
Now you can obtain a token with that client ID and secret
With HTTP Call
POST https://api.ic.peplink.com/api/oauth2/token
Encoding: application/x-www-form-urlencoded
Data: client_id=[your_client_id]&client_secret=[your_client_secret]&grant_type=client_credentials
With CURL command:
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" --data "client_id=[your_client_id]&client_secret=[your_client_secret]&grant_type=client_credentials" https://api.ic.peplink.com/api/oauth2/token
With C#
var request = (HttpWebRequest)WebRequest.Create("https://api.ic.peplink.com/api/oauth2/token");
var postData = "client_id=MyClientId";
postData += "&client_secret=MySecret";
postData += "&grant_type=client_credentials";
var data = Encoding.ASCII.GetBytes(postData);
request.Method = "POST";
request.ContentType = "application/x-www-form-urlencoded";
request.ContentLength = data.Length;
using (var stream = request.GetRequestStream())
{
stream.Write(data, 0, data.Length);
}
var response = (HttpWebResponse)request.GetResponse();
var responseString = new StreamReader(response.GetResponseStream()).ReadToEnd();
With Java 7
HttpURLConnection connection = (HttpURLConnection) new URL("https://api.ic.peplink.com/api/oauth2/token").getConnection();
connection.setMethod("POST");
connection.setHeader("content-type", "application/x-www-form-urlencoded");
String parameters = "client_id=my_client_id&client_secret=my_client_secret&grant_type=client_credentials";
connection.getOutputStream().write(parmaeters.getBytes());
connection.getOutputStream().flush();
StringBuffer sb = new StringBuffer();
BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));
String responseString = reader.readLine();
With Java 8
HttpURLConnection connection = (HttpURLConnection) new URL("https://api.ic.peplink.com/api/oauth2/token").openConnection();
connection.setRequestMethod("POST");
connection.setRequestProperty("content-type", "application/x-www-form-urlencoded");
String parameters = "client_id=my_client_id&client_secret=my_client_secret&grant_type=client_credentials";
connection.getOutputStream().write(parmaeters.getBytes());
connection.getOutputStream().flush();
StringBuffer sb = new StringBuffer();
BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));
String responseString = reader.readLine();
Token Response
If success, you will receive response like below
{"access_token":"your_access_token", "expires_in": 172799, "token_type":"Bearer", "refresh_token":"your_refresh_token"}
Now you can access our system with access token.
https://api.ic.peplink.com/rest/o?access_token=[your_access_token]
Hope above helps, for any question related to InControl2 API, please send email to "ic2api@peplink.com".
https://www.digitalocean.com/community/tutorials/an-introduction-to-oauth-2
Create RESTful API client
1) Login to InControl2
2) In any organization/network/device overview, on the top right hand corner, click on your login email address before the "Sign out" link, that would bring you to account setting page.
3) At the bottom of the page, there is a "Client Application" section, click on "New Client"
4) Enter the name and checked "Enable", other fields can be leave blank, then click "Save"
5) Click on the application name that you just created, you should see "Client ID" and "Client Secret" at the bottom of the popup window
Now you can obtain a token with that client ID and secret
With HTTP Call
POST https://api.ic.peplink.com/api/oauth2/token
Encoding: application/x-www-form-urlencoded
Data: client_id=[your_client_id]&client_secret=[your_client_secret]&grant_type=client_credentials
With CURL command:
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" --data "client_id=[your_client_id]&client_secret=[your_client_secret]&grant_type=client_credentials" https://api.ic.peplink.com/api/oauth2/token
With C#
var request = (HttpWebRequest)WebRequest.Create("https://api.ic.peplink.com/api/oauth2/token");
var postData = "client_id=MyClientId";
postData += "&client_secret=MySecret";
postData += "&grant_type=client_credentials";
var data = Encoding.ASCII.GetBytes(postData);
request.Method = "POST";
request.ContentType = "application/x-www-form-urlencoded";
request.ContentLength = data.Length;
using (var stream = request.GetRequestStream())
{
stream.Write(data, 0, data.Length);
}
var response = (HttpWebResponse)request.GetResponse();
var responseString = new StreamReader(response.GetResponseStream()).ReadToEnd();
With Java 7
HttpURLConnection connection = (HttpURLConnection) new URL("https://api.ic.peplink.com/api/oauth2/token").getConnection();
connection.setMethod("POST");
connection.setHeader("content-type", "application/x-www-form-urlencoded");
String parameters = "client_id=my_client_id&client_secret=my_client_secret&grant_type=client_credentials";
connection.getOutputStream().write(parmaeters.getBytes());
connection.getOutputStream().flush();
StringBuffer sb = new StringBuffer();
BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));
String responseString = reader.readLine();
With Java 8
HttpURLConnection connection = (HttpURLConnection) new URL("https://api.ic.peplink.com/api/oauth2/token").openConnection();
connection.setRequestMethod("POST");
connection.setRequestProperty("content-type", "application/x-www-form-urlencoded");
String parameters = "client_id=my_client_id&client_secret=my_client_secret&grant_type=client_credentials";
connection.getOutputStream().write(parmaeters.getBytes());
connection.getOutputStream().flush();
StringBuffer sb = new StringBuffer();
BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));
String responseString = reader.readLine();
Token Response
If success, you will receive response like below
{"access_token":"your_access_token", "expires_in": 172799, "token_type":"Bearer", "refresh_token":"your_refresh_token"}
Now you can access our system with access token.
https://api.ic.peplink.com/rest/o?access_token=[your_access_token]
Hope above helps, for any question related to InControl2 API, please send email to "ic2api@peplink.com".
Obtain Access Token:
[expand all] | [hide all]
Pretty Print
Result data element only
DELETE
PUT
POST
GET
Since:
Response Content Type:
Parameters
2.13.3
Response Content Type:
application/json
Parameters
Since:
Request Content Type:
Response Content Type:
Parameters
2.13.3
Request Content Type:
application/json
Response Content Type:
application/json
Parameters
Since:
Response Content Type:
Parameters
2.13.3
Response Content Type:
application/json
Parameters
Request Content Type:
Response Content Type:
Parameters
application/json
Response Content Type:
application/json
Parameters
Since:
Response Content Type:
Parameters
2.13.3
Response Content Type:
application/json
Parameters
Since:
Response Content Type:
Parameters
2.13.3
Response Content Type:
application/json
Parameters
Since:
Request Content Type:
Response Content Type:
Parameters
2.13.3
Request Content Type:
application/json
Response Content Type:
application/json
Parameters
Since:
Request Content Type:
Response Content Type:
Parameters
2.13.3
Request Content Type:
application/json
Response Content Type:
application/json
Parameters
Since:
Response Content Type:
Parameters
2.13.3
Response Content Type:
application/json
Parameters
Since:
Response Content Type:
Parameters
2.13.3
Response Content Type:
application/json
Parameters
Response Content Type:
Model Schema
Model | Response Sample | Model Description
[expand] | [collapse]
[expand] | [collapse]
[expand] | [collapse]
Parameters
application/json
Model Schema
Model | Response Sample | Model Description
response { resp_code (string): Response code, caller_ref (string): Caller reference identifier, auto generated if not specified, server_ref (string): Server reference identifier, generated on server side, message (string): Response message, data (array[organization_list_obj]): Response data object, } organization_list_obj { id (string): Organization identifier, name (string): Organization name, primary (boolean): Indicates if the organization is primary, status (string): Organization status, migrateStatus (integer): Indicates the migrate status if the organization is created from a group., }
{ "resp_code": "", "caller_ref": "", "server_ref": "", "message": "", "data": [ { "id": "", "name": "", "primary": true, "status": "", "migrateStatus": 0 } ] }
Field | Type | Description |
---|---|---|
resp_code | string |
Response code
SUCCESS, INVALID_INPUT, INTERNAL_ERROR, PENDING |
caller_ref | string |
Caller reference identifier, auto generated if not specified
|
server_ref | string |
Server reference identifier, generated on server side
|
message | string |
Response message
|
data | array[organization_list_obj] |
Response data object
|
Field | Type | Description |
---|---|---|
id | string |
Organization identifier
|
name | string |
Organization name
|
primary | boolean |
Indicates if the organization is primary
|
status | string |
Organization status
|
migrateStatus | integer |
Indicates the migrate status if the organization is created from a group.
|
Parameters
Response Content Type:
Model Schema
Model | Response Sample | Model Description
[expand] | [collapse]
[expand] | [collapse]
[expand] | [collapse]
Parameters
application/json
Model Schema
Model | Response Sample | Model Description
response { resp_code (string): Response code, caller_ref (string): Caller reference identifier, auto generated if not specified, server_ref (string): Server reference identifier, generated on server side, message (string): Response message, data (organization): Response data object, } organization { id (string): Organization identifier, name (string): Organization name, address (string): Static location address, createdAt (string): Creation date and time, updatedAt (string): Last updated date and time, longitude (number): Static location longitude, latitude (number): Static location latitude, country (string): Organization country, lastActivityDate (string): Last activity of organization, adServerUrl (string): Ad server url, status (string): Organization status, primary (boolean): Indicates if the organization is primary, googleMapEnabled (integer): Indicates which Map service enabled, 0 - OpenStreetMap, 1 or 2 - OpenMapTiles, speedUnit (string): Unit, "km"-Metric, "miles"-Imperial, "knot"-Nautical, migrateStatus (integer): Indicates the migrate status if the organization is created from group., adminSettings (string): Organization admin settings, }
{ "resp_code": "", "caller_ref": "", "server_ref": "", "message": "", "data": { "id": "", "name": "", "address": "", "createdAt": "", "updatedAt": "", "longitude": 0.0, "latitude": 0.0, "country": "", "lastActivityDate": "", "adServerUrl": "", "status": "", "primary": true, "googleMapEnabled": 0, "speedUnit": "", "migrateStatus": 0, "adminSettings": "" } }
Field | Type | Description |
---|---|---|
resp_code | string |
Response code
SUCCESS, INVALID_INPUT, INTERNAL_ERROR, PENDING |
caller_ref | string |
Caller reference identifier, auto generated if not specified
|
server_ref | string |
Server reference identifier, generated on server side
|
message | string |
Response message
|
data | organization |
Response data object
|
Field | Type | Description |
---|---|---|
id | string |
Organization identifier
|
name | string |
Organization name
|
address | string |
Static location address
|
createdAt | string |
Creation date and time
|
updatedAt | string |
Last updated date and time
|
longitude | number |
Static location longitude
|
latitude | number |
Static location latitude
|
country | string |
Organization country
|
lastActivityDate | string |
Last activity of organization
|
adServerUrl | string |
Ad server url
|
status | string |
Organization status
|
primary | boolean |
Indicates if the organization is primary
|
googleMapEnabled | integer |
Indicates which Map service enabled, 0 - OpenStreetMap, 1 or 2 - OpenMapTiles
0, 1, 2 |
speedUnit | string |
Unit, "km"-Metric, "miles"-Imperial, "knot"-Nautical
km, miles, knot |
migrateStatus | integer |
Indicates the migrate status if the organization is created from group.
|
adminSettings | string |
Organization admin settings
|
Parameters
GET
/rest/o/{organization_id}/bandwidth_per_device
Get bandwidth usage per device in the organization
Response Content Type:
Parameters
application/json
Parameters
GET
/rest/o/{organization_id}/bandwidth_per_device/csv
Get bandwidth usage per device in the organization
Response Content Type:
Parameters
application/json
Parameters
GET
/rest/o/{organization_id}/d
Get an organization's device list.
When has_status is specified, for online devices, some status information (e.g. (WAN) interfaces, (data) usage, etc.) will be included. The system will trigger the devices to report the data in real-time. Before the fresh data (i.e. received in last 2 minutes) is available, no status information will be included. When fresh data is available (typically 1 to 2 seconds after a trigger), the status information will be included.
Response Content Type:
Model Schema
Model | Response Sample | Model Description
[expand] | [collapse]
[expand] | [collapse]
[expand] | [collapse]
Parameters
application/json
Model Schema
Model | Response Sample | Model Description
response { resp_code (string): Response code, caller_ref (string): Caller reference identifier, auto generated if not specified, server_ref (string): Server reference identifier, generated on server side, message (string): Response message, data (array[device_list_obj]): Response data object, } device_list_obj { id (integer): Unique identifier of the device, group_id (integer): Unique identifier of the group, group_name (string): Name of the group, sn (string): Device S/N, name (string): Device name, status (string): Device status, usage (number): Current bandwidth usage, product_id (integer): Unique identifier of the product, client_count (integer): Current client count, fw_ver (string): Firmware version using, last_online (string): Last online date and time, offline_at (string): Last offline date and time, first_appear (string): First appeared date and time, lan_mac (string): LAN MAC address, config_rollback (boolean): Indicates if the recent change in outbound policy or firewall rules applied from InControl has been rolled back as the device was unable to reach InControl., config_rollback_date (string): Config roll back date and time, ic2_config_apply_locked (boolean): Indicates if the device is "Config Locked" by InControl, outstanding_patch_ids (array[string]): Unique identifier of the outstanding configuration patches, device_config_apply_locked (boolean): Indicates if the device is "Config Locked" by device, sp_default (boolean): Indicates if the active configuration is saved as SP default, product_name (string): Product name, product_code (string): Product code, mv (string): Model variant, tags (array[string]): List of Device tags name, note (string): Note, address (string): Location address, follow_loc_dev (integer): Device's ID of the followed location device, expiry_date (string): Warranty expiry date, sub_expiry_date (string): Subscription expiry date, prime_expiry_date (string): Prime expiry date, prime_type (integer): Prime Type: 1 - with prime subscription, 0 or undefined - without prime subscription, expired (boolean): Indicates if the device warranty has expired, sub_expired (boolean): Indicates if the device subscription has expired, gps_support (boolean): Indicates if the device support gps, gps_exist (boolean): Indicates if the device with any gps records, support_ssid_count (number): Supported number of SSIDs, group_type (string): Group type, device_type (string): Device type, last_sync_date (string): Last config applied date and time, uptime (integer): Device up time, uptime_appear (string): Retrieval time of the device up time, fw_pending_trial_round (integer): Firmware update trial count, fw_pending_max_no_of_trial (integer): Maximum number of firmware update trial count, fw_pending_ver (string): Version of the firmware to be updated, fw_pending_schedule_time (string): Scheduled firmware update start time, fw_pending_upgrade_time (string): Actual firmware update time, fw_pending_status (integer): Firmware update status, 1 - active, 0 - inactive, fw_pending_group_time (string): Pending firmware update time in the group's time zone, is_master_device (boolean): Indicates if the device is a master configuration cloning device, fw_managmed (string): (only for device detail call) Indicates if the firmware is managed by organization level, group level or device level, wifi_cfg (string): Indicates the device follows group or device level's SSID settings, or locally managed on the device, ddns_enabled (boolean): Indicates if "Find My Peplink Service" enabled, ddns_letsencrypt_enabled (boolean): Indicates if "Manage Web Admin SSL Certificate" is enabled for "Find My Peplink Service", ddns_letsencrypt_cert_expiry_date (string): Web Admin SSL certificate expiry date and time, ddns_letsencrypt_apply_date (string): Web Admin SSL certificate apply date and time, ddns_name (string): "Find My Peplink Service", ddns_available (boolean): Indicates if "Find My Peplink Service" available, ddns_resolve_private_ip (boolean): Indicates if "Find My Peplink Service - Resolve Private IP address" enabled, onlineStatus (string): Current online status, wtp_ip (string): Last Detected IP, interfaces (array[interface|interface_polling_obj]): Device interfaces information, vlan_interfaces (array[vlan_interface]): VLAN interfaces, ssid_profiles_applied (array[ssid_profiles_applied]): Applied SSID profiles, hardware_version (string): Hardware version, mvpn_version (string): MVPN version, radio_bands (array[radio_band]): Radio bands, loc_display (boolean): Indicates if address displayed on "Location" field in InControl Device Detail Page: true - display address, false - display latitude/longitude, extap_proxy_supported (boolean): Indicates if the device is a AP controller, extap_proxy_enabled (boolean): Indicates if the device is a managed by AP controller, wlan_probe_supported (boolean): Indicates if the device supports "Collecting Wi-Fi Analytics Data", wlan_probe_enabled (boolean): Indicates if the device enabled "Collecting Wi-Fi Analytics Data" in InControl, dpi_supported (boolean): Indicates if the device supports deep packet inspection, dpi_enabled (boolean): Indicates if the device enabled deep packet inspection, low_data_usage_mode (boolean): Indicates if the device enabled low data usage mode, ra_enabled (boolean): Indicates if the device enabled remote assistance, watchdog_enabled (boolean): Indicates if the device enabled hardware watchdog, ra_supported (boolean): Indicates if the device support remote assistance, watchdog_supported (boolean): Indicates if the device support hardware watchdog, ap_router_mode (boolean): Indicates if the device applied router mode, true - router mode, false - bridge mode, ssid_mac_list (array[ssid_mac_list]): SSID mac list, site_id (string): PepVPN Site ID, route_isolation (boolean): PepVPN Route Isolation, hub_support (boolean): , dr_support (boolean): , endpoint_support (boolean): , handshake_port (boolean): (PepVPN / SpeedFusion Configuration) Handshake port, refuse_legacy (boolean): (PepVPN / SpeedFusion Configuration) Indicates if the device accept connections from legacy firmware, peer_connections (integer): PepVPN / SpeedFusion Peer Connections, pepvpn_peers (integer): Maximum number of PepVPN / SpeedFusion Peer Connections, is_default_password (boolean): Indicates if default password is used in device web admin,, is_wlan_ap_suspended (boolean): Indicates if the device WLAN AP is suspended, is_ap_schedule_enabled (boolean): Indicates if the device AP schedule enabled, is_ha_enabled (boolean): Indicates if high availability enabled, is_ha_slave (boolean): Indicates if the device is a high availability slave unit, ha_role (string): High Availability Preferred Role (master|slave), ha_status (string): High Availability Status, ha_transition_time (string): Last Transition Date and time, periph_status_available (boolean): Indicates if periph status is available, periph_status (periph_status): Periph status, gobi_sim_lock_supported (boolean): Indicates if the device support SIM lock, gobi_sim_locks (array[string]): , poe_supported (boolean): Indicates if the device support poe, } interface { id (integer): System generated interface identifier, type (string): Interface type, status (string): Interface status for InControl, Connected|Disconnected|Disabled|No SIM Card Detected|No Cable Detected, last_status (string): Wan status, Only exists if the device is offline, name (string): Interface name, ddns_host (string): DDNS host, ddns_name (string): Find My Peplink Address, ddns_enabled (boolean): Indicates if DDNS is enabled, dns_servers (array[string]): List of dns servers, ip_status (string): , conn_len (integer): , ip (string): IP, netmask (string): Netmask, is_enable (boolean): Indicates if the interface is enabled, conn_mode (integer): Routing mode, port_type (integer): Port type, gateway (string): Default gateway, mtu (number): MTU, healthcheck (string): Health check method, "nslookup" - DNS Lookup, "pstr" - SmartCheck, "disabled" - Disabled, "ping" - PING, "http" - HTTP, sims (interface_sims): SIMs info, meid_hex (string): MEID DEC, esn (string): ESN, imei (string): IMEI, imei_cdf (string): Cellular Module, apn (string): APN, username (string): Username for APN, password (string): Password for APN, dialnum (string): Dial Number for APN, carrier_name (string): Carrier, carrier_settings (string): Carrier settings, s2g3glte (string): Indicates if the network is "3G", "4G" or "LTE", signal_bar (integer): Indicates the signal bar level, -1: no signal, 0-5: signal bar level, gobi_data_tech (string): Network, gobi_band_class_name (string): Network band, gobi_band_2_class_name (string): Secondary band, cellular_signals (interface_cellular_signals): Cellular signals, gobi_band_2_cellular_signals (interface_cellular_signals): Cellular signals, cell_id (integer): Cell ID, adaptor_type (string): Modem adaptor type, vendor_id (integer): Modem adaptor vendor ID, product_id (integer): Modem adaptor product ID, modem_name (string): Modem adaptor name, modem_manufacturer (string): Modem adaptor manufacturer, status_led (string): Indicates the interface status in color in InControl, is_overall_up (integer): , standby_state (string): Standby state, connected|disconnect, mtu_state (integer): , healthy_state (integer): , connection_state (integer): Connection state, physical_state (integer): Physical state, is_backup (integer): , is_quota_exceed (integer): , is_manual_disconnect (integer): , conn_config_method (string): Connection Method, standby_mode (string): Standby mode, mtu_config (integer): MTU config, group (integer): Indicates the priority group id, updated_at (string): Interface info updated date and time, } interface_sims { imsi (string): IMSI, iccid (string): ICCID, status (string): SIM Status, active (boolean): Indicates if the SIM is active, bandwidthAllowanceMonitor (interface_sims_bandwdith_allowance_monitor): Bandwidth allowance monitor information of the WAN connection or SIM, } interface_sims_bandwdith_allowance_monitor { enable (boolean): Indicates if the bandwidth allowance monitor is enabled, } interface_cellular_signals { rssi (number): Signal Strength in RSSI (dBm), sinr (number): Signal Quality in SINR (dB), rsrp (number): Signal Strength in RSRP (dBm), rsrq (number): Signal Quality in RSRQ (dB), } interface_polling_obj { id (integer): System generated interface identifier, name (string): Interface name, msg (string): "Polling from device" indicates the interface data is not ready yet., } vlan_interface { vlan_id (integer): VLAN ID, vlan_ip (string): VLAN IP, netmask (string): VLAN netmask, name (string): VLAN name, icmg (boolean): Indicates if the VLAN is managed by InControl, portal_id (integer): Unique identifier of VLAN portal, portal_name (string): Name of the VLAN portal, portal_enabled (boolean): Indicates if the VLAN portal is enabled, } ssid_profiles_applied { id (integer): System generated SSID profile identifier, ssid (string): SSID, group_id (integer): Unique identifier of the group, device_id (integer): Unique identifier of the device, portal_id (integer): Unique identifier of the captive portal/external captive portal, enabled (boolean): Indicates if the ssid profile is enabled, icMg (boolean): Indicates if the ssid profile is managed by InControl, vlan_id (integer): VLAN ID, portal_custom (boolean): Indicates if the portal is external captive portal, wpa_passphrase (string): WPA passphrase, the field would be hidden for read-only users, } radio_band { radio_bands (integer): Unique identifier of the radio band, active_band (string): The active frequency band, txpower (number): Output power, channel (integer): Channel, channel_mode (string): Channel Mode, } ssid_mac_list { bssid (string): BSSID of the ESSID, essid (string): ESSID, radio (string): Radio band, security (string): the security policy of the SSID, } periph_status { cpu_load (usage_data): CPU load, power_state (power_state): Power State, power_usage (usage_data): Power Usage, fan_speed (usage_data): Fan speed, thermal_sensor (temperature): Thermal Sensor, } usage_data { name (string): Name, value (number): Value, total (number): Total, voltage (number): Voltage, current (number): Current, percentage (number): Percentage, active (boolean): Active, } power_state { name (string): Name, connect (boolean): Indicates if the power is connected, } temperature { temperature (number): Temperature, max (number): Maximum, threshold (number): Threshold, min (number): Minimum, }
{ "resp_code": "", "caller_ref": "", "server_ref": "", "message": "", "data": [ { "id": 0, "group_id": 0, "group_name": "", "sn": "", "name": "", "status": "", "usage": 0.0, "product_id": 0, "client_count": 0, "fw_ver": "", "last_online": "", "offline_at": "", "first_appear": "", "lan_mac": "", "config_rollback": true, "config_rollback_date": "", "ic2_config_apply_locked": true, "outstanding_patch_ids": [ "" ], "device_config_apply_locked": true, "sp_default": true, "product_name": "", "product_code": "", "mv": "", "tags": [ "" ], "note": "", "address": "", "follow_loc_dev": 0, "expiry_date": "", "sub_expiry_date": "", "prime_expiry_date": "", "prime_type": 0, "expired": true, "sub_expired": true, "gps_support": true, "gps_exist": true, "support_ssid_count": 0.0, "group_type": "", "device_type": "", "last_sync_date": "", "uptime": 0, "uptime_appear": "", "fw_pending_trial_round": 0, "fw_pending_max_no_of_trial": 0, "fw_pending_ver": "", "fw_pending_schedule_time": "", "fw_pending_upgrade_time": "", "fw_pending_status": 0, "fw_pending_group_time": "", "is_master_device": true, "fw_managmed": "", "wifi_cfg": "", "ddns_enabled": true, "ddns_letsencrypt_enabled": true, "ddns_letsencrypt_cert_expiry_date": "", "ddns_letsencrypt_apply_date": "", "ddns_name": "", "ddns_available": true, "ddns_resolve_private_ip": true, "onlineStatus": "", "wtp_ip": "", "interfaces": { "id": 0, "type": "", "status": "", "last_status": "", "name": "", "ddns_host": "", "ddns_name": "", "ddns_enabled": true, "dns_servers": [ "" ], "ip_status": "", "conn_len": 0, "ip": "", "netmask": "", "is_enable": true, "conn_mode": 0, "port_type": 0, "gateway": "", "mtu": 0.0, "healthcheck": "", "sims": { "imsi": "", "iccid": "", "status": "", "active": true, "bandwidthAllowanceMonitor": { "enable": true } }, "meid_hex": "", "esn": "", "imei": "", "imei_cdf": "", "apn": "", "username": "", "password": "", "dialnum": "", "carrier_name": "", "carrier_settings": "", "s2g3glte": "", "signal_bar": 0, "gobi_data_tech": "", "gobi_band_class_name": "", "gobi_band_2_class_name": "", "cellular_signals": { "rssi": 0.0, "sinr": 0.0, "rsrp": 0.0, "rsrq": 0.0 }, "gobi_band_2_cellular_signals": { "rssi": 0.0, "sinr": 0.0, "rsrp": 0.0, "rsrq": 0.0 }, "cell_id": 0, "adaptor_type": "", "vendor_id": 0, "product_id": 0, "modem_name": "", "modem_manufacturer": "", "status_led": "", "is_overall_up": 0, "standby_state": "", "mtu_state": 0, "healthy_state": 0, "connection_state": 0, "physical_state": 0, "is_backup": 0, "is_quota_exceed": 0, "is_manual_disconnect": 0, "conn_config_method": "", "standby_mode": "", "mtu_config": 0, "group": 0, "updated_at": "" }, "vlan_interfaces": [ { "vlan_id": 0, "vlan_ip": "", "netmask": "", "name": "", "icmg": true, "portal_id": 0, "portal_name": "", "portal_enabled": true } ], "ssid_profiles_applied": [ { "id": 0, "ssid": "", "group_id": 0, "device_id": 0, "portal_id": 0, "enabled": true, "icMg": true, "vlan_id": 0, "portal_custom": true, "wpa_passphrase": "" } ], "hardware_version": "", "mvpn_version": "", "radio_bands": [ { "radio_bands": 0, "active_band": "", "txpower": 0.0, "channel": 0, "channel_mode": "" } ], "loc_display": true, "extap_proxy_supported": true, "extap_proxy_enabled": true, "wlan_probe_supported": true, "wlan_probe_enabled": true, "dpi_supported": true, "dpi_enabled": true, "low_data_usage_mode": true, "ra_enabled": true, "watchdog_enabled": true, "ra_supported": true, "watchdog_supported": true, "ap_router_mode": true, "ssid_mac_list": [ { "bssid": "", "essid": "", "radio": "", "security": "" } ], "site_id": "", "route_isolation": true, "hub_support": true, "dr_support": true, "endpoint_support": true, "handshake_port": true, "refuse_legacy": true, "peer_connections": 0, "pepvpn_peers": 0, "is_default_password": true, "is_wlan_ap_suspended": true, "is_ap_schedule_enabled": true, "is_ha_enabled": true, "is_ha_slave": true, "ha_role": "", "ha_status": "", "ha_transition_time": "", "periph_status_available": true, "periph_status": { "cpu_load": { "name": "", "value": 0.0, "total": 0.0, "voltage": 0.0, "current": 0.0, "percentage": 0.0, "active": true }, "power_state": { "name": "", "connect": true }, "power_usage": { "name": "", "value": 0.0, "total": 0.0, "voltage": 0.0, "current": 0.0, "percentage": 0.0, "active": true }, "fan_speed": { "name": "", "value": 0.0, "total": 0.0, "voltage": 0.0, "current": 0.0, "percentage": 0.0, "active": true }, "thermal_sensor": { "temperature": 0.0, "max": 0.0, "threshold": 0.0, "min": 0.0 } }, "gobi_sim_lock_supported": true, "gobi_sim_locks": [ "" ], "poe_supported": true } ] }
Field | Type | Description |
---|---|---|
resp_code | string |
Response code
SUCCESS, INVALID_INPUT, INTERNAL_ERROR, PENDING |
caller_ref | string |
Caller reference identifier, auto generated if not specified
|
server_ref | string |
Server reference identifier, generated on server side
|
message | string |
Response message
|
data | array[device_list_obj] |
Response data object
|
Field | Type | Description |
---|---|---|
id | integer |
Unique identifier of the device
|
group_id | integer |
Unique identifier of the group
|
group_name | string |
Name of the group
|
sn | string |
Device S/N
|
name | string |
Device name
|
status | string |
Device status
online, offline |
usage | number |
Current bandwidth usage
|
product_id | integer |
Unique identifier of the product
|
client_count | integer |
Current client count
|
fw_ver | string |
Firmware version using
|
last_online | string |
Last online date and time
|
offline_at | string |
Last offline date and time
|
first_appear | string |
First appeared date and time
|
lan_mac | string |
LAN MAC address
|
config_rollback | boolean |
Indicates if the recent change in outbound policy or firewall rules applied from InControl has been rolled back as the device was unable to reach InControl.
|
config_rollback_date | string |
Config roll back date and time
|
ic2_config_apply_locked | boolean |
Indicates if the device is "Config Locked" by InControl
|
outstanding_patch_ids | array[string] |
Unique identifier of the outstanding configuration patches
|
device_config_apply_locked | boolean |
Indicates if the device is "Config Locked" by device
|
sp_default | boolean |
Indicates if the active configuration is saved as SP default
|
product_name | string |
Product name
|
product_code | string |
Product code
|
mv | string |
Model variant
|
tags | array[string] |
List of Device tags name
|
note | string |
Note
|
address | string |
Location address
|
follow_loc_dev | integer |
Device's ID of the followed location device
|
expiry_date | string |
Warranty expiry date
|
sub_expiry_date | string |
Subscription expiry date
|
prime_expiry_date | string |
Prime expiry date
|
prime_type | integer |
Prime Type: 1 - with prime subscription, 0 or undefined - without prime subscription
0, 1 |
expired | boolean |
Indicates if the device warranty has expired
|
sub_expired | boolean |
Indicates if the device subscription has expired
|
gps_support | boolean |
Indicates if the device support gps
|
gps_exist | boolean |
Indicates if the device with any gps records
|
support_ssid_count | number |
Supported number of SSIDs
|
group_type | string |
Group type
peplink |
device_type | string |
Device type
|
last_sync_date | string |
Last config applied date and time
|
uptime | integer |
Device up time
|
uptime_appear | string |
Retrieval time of the device up time
|
fw_pending_trial_round | integer |
Firmware update trial count
|
fw_pending_max_no_of_trial | integer |
Maximum number of firmware update trial count
|
fw_pending_ver | string |
Version of the firmware to be updated
|
fw_pending_schedule_time | string |
Scheduled firmware update start time
|
fw_pending_upgrade_time | string |
Actual firmware update time
|
fw_pending_status | integer |
Firmware update status, 1 - active, 0 - inactive
0, 1 |
fw_pending_group_time | string |
Pending firmware update time in the group's time zone
|
is_master_device | boolean |
Indicates if the device is a master configuration cloning device
|
fw_managmed | string |
(only for device detail call) Indicates if the firmware is managed by organization level, group level or device level
|
wifi_cfg | string |
Indicates the device follows group or device level's SSID settings, or locally managed on the device
group, device, not_managed |
ddns_enabled | boolean |
Indicates if "Find My Peplink Service" enabled
|
ddns_letsencrypt_enabled | boolean |
Indicates if "Manage Web Admin SSL Certificate" is enabled for "Find My Peplink Service"
|
ddns_letsencrypt_cert_expiry_date | string |
Web Admin SSL certificate expiry date and time
|
ddns_letsencrypt_apply_date | string |
Web Admin SSL certificate apply date and time
|
ddns_name | string |
"Find My Peplink Service"
|
ddns_available | boolean |
Indicates if "Find My Peplink Service" available
|
ddns_resolve_private_ip | boolean |
Indicates if "Find My Peplink Service - Resolve Private IP address" enabled
|
onlineStatus | string |
Current online status
|
wtp_ip | string |
Last Detected IP
|
interfaces | array[interface|interface_polling_obj] |
Device interfaces information
|
vlan_interfaces | array[vlan_interface] |
VLAN interfaces
|
ssid_profiles_applied | array[ssid_profiles_applied] |
Applied SSID profiles
|
hardware_version | string |
Hardware version
|
mvpn_version | string |
MVPN version
|
radio_bands | array[radio_band] |
Radio bands
|
loc_display | boolean |
Indicates if address displayed on "Location" field in InControl Device Detail Page: true - display address, false - display latitude/longitude
|
extap_proxy_supported | boolean |
Indicates if the device is a AP controller
|
extap_proxy_enabled | boolean |
Indicates if the device is a managed by AP controller
|
wlan_probe_supported | boolean |
Indicates if the device supports "Collecting Wi-Fi Analytics Data"
|
wlan_probe_enabled | boolean |
Indicates if the device enabled "Collecting Wi-Fi Analytics Data" in InControl
|
dpi_supported | boolean |
Indicates if the device supports deep packet inspection
|
dpi_enabled | boolean |
Indicates if the device enabled deep packet inspection
|
low_data_usage_mode | boolean |
Indicates if the device enabled low data usage mode
|
ra_enabled | boolean |
Indicates if the device enabled remote assistance
2.8.3 |
watchdog_enabled | boolean |
Indicates if the device enabled hardware watchdog
2.8.3 |
ra_supported | boolean |
Indicates if the device support remote assistance
2.8.3 |
watchdog_supported | boolean |
Indicates if the device support hardware watchdog
2.8.3 |
ap_router_mode | boolean |
Indicates if the device applied router mode, true - router mode, false - bridge mode
|
ssid_mac_list | array[ssid_mac_list] |
SSID mac list
|
site_id | string |
PepVPN Site ID
|
route_isolation | boolean |
PepVPN Route Isolation
|
hub_support | boolean | |
dr_support | boolean | |
endpoint_support | boolean | |
handshake_port | boolean |
(PepVPN / SpeedFusion Configuration) Handshake port
|
refuse_legacy | boolean |
(PepVPN / SpeedFusion Configuration) Indicates if the device accept connections from legacy firmware
|
peer_connections | integer |
PepVPN / SpeedFusion Peer Connections
|
pepvpn_peers | integer |
Maximum number of PepVPN / SpeedFusion Peer Connections
|
is_default_password | boolean |
Indicates if default password is used in device web admin,
|
is_wlan_ap_suspended | boolean |
Indicates if the device WLAN AP is suspended
|
is_ap_schedule_enabled | boolean |
Indicates if the device AP schedule enabled
|
is_ha_enabled | boolean |
Indicates if high availability enabled
|
is_ha_slave | boolean |
Indicates if the device is a high availability slave unit
|
ha_role | string |
High Availability Preferred Role (master|slave)
|
ha_status | string |
High Availability Status
|
ha_transition_time | string |
Last Transition Date and time
|
periph_status_available | boolean |
Indicates if periph status is available
|
periph_status | periph_status |
Periph status
|
gobi_sim_lock_supported | boolean |
Indicates if the device support SIM lock
|
gobi_sim_locks | array[string] | |
poe_supported | boolean |
Indicates if the device support poe
|
Field | Type | Description |
---|---|---|
id | integer |
System generated interface identifier
|
type | string |
Interface type
|
status | string |
Interface status for InControl, Connected|Disconnected|Disabled|No SIM Card Detected|No Cable Detected
|
last_status | string |
Wan status, Only exists if the device is offline
|
name | string |
Interface name
|
ddns_host | string |
DDNS host
|
ddns_name | string |
Find My Peplink Address
|
ddns_enabled | boolean |
Indicates if DDNS is enabled
|
dns_servers | array[string] |
List of dns servers
|
ip_status | string | |
conn_len | integer | |
ip | string |
IP
|
netmask | string |
Netmask
|
is_enable | boolean |
Indicates if the interface is enabled
|
conn_mode | integer |
Routing mode
|
port_type | integer |
Port type
|
gateway | string |
Default gateway
|
mtu | number |
MTU
|
healthcheck | string |
Health check method, "nslookup" - DNS Lookup, "pstr" - SmartCheck, "disabled" - Disabled, "ping" - PING, "http" - HTTP
|
sims | interface_sims |
SIMs info
|
meid_hex | string |
MEID DEC
|
esn | string |
ESN
|
imei | string |
IMEI
|
imei_cdf | string |
Cellular Module
|
apn | string |
APN
|
username | string |
Username for APN
|
password | string |
Password for APN
|
dialnum | string |
Dial Number for APN
|
carrier_name | string |
Carrier
|
carrier_settings | string |
Carrier settings
|
s2g3glte | string |
Indicates if the network is "3G", "4G" or "LTE"
|
signal_bar | integer |
Indicates the signal bar level, -1: no signal, 0-5: signal bar level
|
gobi_data_tech | string |
Network
|
gobi_band_class_name | string |
Network band
|
gobi_band_2_class_name | string |
Secondary band
|
cellular_signals | interface_cellular_signals |
Cellular signals
|
gobi_band_2_cellular_signals | interface_cellular_signals |
Cellular signals
|
cell_id | integer |
Cell ID
|
adaptor_type | string |
Modem adaptor type
|
vendor_id | integer |
Modem adaptor vendor ID
|
product_id | integer |
Modem adaptor product ID
|
modem_name | string |
Modem adaptor name
|
modem_manufacturer | string |
Modem adaptor manufacturer
|
status_led | string |
Indicates the interface status in color in InControl
|
is_overall_up | integer | |
standby_state | string |
Standby state, connected|disconnect
|
mtu_state | integer | |
healthy_state | integer | |
connection_state | integer |
Connection state
|
physical_state | integer |
Physical state
|
is_backup | integer | |
is_quota_exceed | integer | |
is_manual_disconnect | integer | |
conn_config_method | string |
Connection Method
|
standby_mode | string |
Standby mode
|
mtu_config | integer |
MTU config
|
group | integer |
Indicates the priority group id
|
updated_at | string |
Interface info updated date and time
|
Field | Type | Description |
---|---|---|
imsi | string |
IMSI
|
iccid | string |
ICCID
|
status | string |
SIM Status
|
active | boolean |
Indicates if the SIM is active
|
bandwidthAllowanceMonitor | interface_sims_bandwdith_allowance_monitor |
Bandwidth allowance monitor information of the WAN connection or SIM
|
Field | Type | Description |
---|---|---|
enable | boolean |
Indicates if the bandwidth allowance monitor is enabled
|
Field | Type | Description |
---|---|---|
rssi | number |
Signal Strength in RSSI (dBm)
|
sinr | number |
Signal Quality in SINR (dB)
|
rsrp | number |
Signal Strength in RSRP (dBm)
|
rsrq | number |
Signal Quality in RSRQ (dB)
|
Field | Type | Description |
---|---|---|
id | integer |
System generated interface identifier
|
name | string |
Interface name
|
msg | string |
"Polling from device" indicates the interface data is not ready yet.
|
Field | Type | Description |
---|---|---|
vlan_id | integer |
VLAN ID
|
vlan_ip | string |
VLAN IP
|
netmask | string |
VLAN netmask
|
name | string |
VLAN name
|
icmg | boolean |
Indicates if the VLAN is managed by InControl
|
portal_id | integer |
Unique identifier of VLAN portal
|
portal_name | string |
Name of the VLAN portal
|
portal_enabled | boolean |
Indicates if the VLAN portal is enabled
|
Field | Type | Description |
---|---|---|
id | integer |
System generated SSID profile identifier
|
ssid | string |
SSID
|
group_id | integer |
Unique identifier of the group
|
device_id | integer |
Unique identifier of the device
|
portal_id | integer |
Unique identifier of the captive portal/external captive portal
|
enabled | boolean |
Indicates if the ssid profile is enabled
|
icMg | boolean |
Indicates if the ssid profile is managed by InControl
|
vlan_id | integer |
VLAN ID
|
portal_custom | boolean |
Indicates if the portal is external captive portal
|
wpa_passphrase | string |
WPA passphrase, the field would be hidden for read-only users
|
Field | Type | Description |
---|---|---|
radio_bands | integer |
Unique identifier of the radio band
|
active_band | string |
The active frequency band
|
txpower | number |
Output power
|
channel | integer |
Channel
|
channel_mode | string |
Channel Mode
|
Field | Type | Description |
---|---|---|
bssid | string |
BSSID of the ESSID
|
essid | string |
ESSID
|
radio | string |
Radio band
|
security | string |
the security policy of the SSID
|
Field | Type | Description |
---|---|---|
cpu_load | usage_data |
CPU load
|
power_state | power_state |
Power State
|
power_usage | usage_data |
Power Usage
|
fan_speed | usage_data |
Fan speed
|
thermal_sensor | temperature |
Thermal Sensor
|
Field | Type | Description |
---|---|---|
name | string |
Name
|
value | number |
Value
|
total | number |
Total
|
voltage | number |
Voltage
|
current | number |
Current
|
percentage | number |
Percentage
|
active | boolean |
Active
|
Field | Type | Description |
---|---|---|
name | string |
Name
|
connect | boolean |
Indicates if the power is connected
|
Field | Type | Description |
---|---|---|
temperature | number |
Temperature
|
max | number |
Maximum
|
threshold | number |
Threshold
|
min | number |
Minimum
|
Parameters
GET
/rest/o/{organization_id}/d/basic
Get an organization's devices list with most basic information only (for shorter load time with large device list)
Since:
Response Content Type:
Model Schema
Model | Response Sample | Model Description
[expand] | [collapse]
[expand] | [collapse]
[expand] | [collapse]
Parameters
2.9.2
Response Content Type:
application/json
Model Schema
Model | Response Sample | Model Description
response { resp_code (string): Response code, caller_ref (string): Caller reference identifier, auto generated if not specified, server_ref (string): Server reference identifier, generated on server side, message (string): Response message, data (array[device_list_basic_obj]): Response data object, } device_list_basic_obj { id (integer): Unique identifier of the device, group_id (integer): Unique identifier of the group, group_name (string): Name of the group, sn (string): Device S/N, name (string): Device name, status (string): Device status, product_id (integer): Unique identifier of the product, fw_ver (string): Firmware version using, last_online (string): Last online date and time, offline_at (string): Last offline date and time, first_appear (string): First appeared date and time, lan_mac (string): LAN MAC address, interfaces (array[interface]): Device interfaces, vlan_interfaces (array[vlan_interface]): VLAN interfaces, product_name (string): Product name, product_code (string): Product code, mv (string): Model variant, tags (array[string]): List of Device tags name, note (string): Note, address (string): Location address, expiry_date (string): Warranty expiry date, sub_expiry_date (string): Subscription expiry date, prime_expiry_date (string): Prime expiry date, prime_type (integer): Prime Type: 1 - with prime subscription, 0 or undefined - without prime subscription, expired (boolean): Indicates if the device warranty has expired, sub_expired (boolean): Indicates if the device subscription has expired, ssid_mac_list (array[ssid_mac_list]): SSID mac list, group_type (string): Group type, device_type (string): Device type, last_sync_date (string): Last config applied date and time, uptime (integer): Device up time, uptime_appear (string): Retrieval time of the device up time, ddns_enabled (boolean): Indicates if "Find My Peplink Service" enabled, ddns_letsencrypt_enabled (boolean): Indicates if "Manage Web Admin SSL Certificate" is enabled for "Find My Peplink Service", onlineStatus (string): Current online status, wtp_ip (string): Last Detected IP, site_id (string): PepVPN Site ID, pepvpn_peers (integer): Maximum number of PepVPN / SpeedFusion Peer Connections, route_isolation (boolean): PepVPN Route Isolation, hub_support (boolean): , dr_support (boolean): , endpoint_support (boolean): , mvpn_license (integer): , } interface { id (integer): System generated interface identifier, type (string): Interface type, status (string): Interface status for InControl, Connected|Disconnected|Disabled|No SIM Card Detected|No Cable Detected, last_status (string): Wan status, Only exists if the device is offline, name (string): Interface name, ddns_host (string): DDNS host, ddns_name (string): Find My Peplink Address, ddns_enabled (boolean): Indicates if DDNS is enabled, dns_servers (array[string]): List of dns servers, ip_status (string): , conn_len (integer): , ip (string): IP, netmask (string): Netmask, is_enable (boolean): Indicates if the interface is enabled, conn_mode (integer): Routing mode, port_type (integer): Port type, gateway (string): Default gateway, mtu (number): MTU, healthcheck (string): Health check method, "nslookup" - DNS Lookup, "pstr" - SmartCheck, "disabled" - Disabled, "ping" - PING, "http" - HTTP, sims (interface_sims): SIMs info, meid_hex (string): MEID DEC, esn (string): ESN, imei (string): IMEI, imei_cdf (string): Cellular Module, apn (string): APN, username (string): Username for APN, password (string): Password for APN, dialnum (string): Dial Number for APN, carrier_name (string): Carrier, carrier_settings (string): Carrier settings, s2g3glte (string): Indicates if the network is "3G", "4G" or "LTE", signal_bar (integer): Indicates the signal bar level, -1: no signal, 0-5: signal bar level, gobi_data_tech (string): Network, gobi_band_class_name (string): Network band, gobi_band_2_class_name (string): Secondary band, cellular_signals (interface_cellular_signals): Cellular signals, gobi_band_2_cellular_signals (interface_cellular_signals): Cellular signals, cell_id (integer): Cell ID, adaptor_type (string): Modem adaptor type, vendor_id (integer): Modem adaptor vendor ID, product_id (integer): Modem adaptor product ID, modem_name (string): Modem adaptor name, modem_manufacturer (string): Modem adaptor manufacturer, status_led (string): Indicates the interface status in color in InControl, is_overall_up (integer): , standby_state (string): Standby state, connected|disconnect, mtu_state (integer): , healthy_state (integer): , connection_state (integer): Connection state, physical_state (integer): Physical state, is_backup (integer): , is_quota_exceed (integer): , is_manual_disconnect (integer): , conn_config_method (string): Connection Method, standby_mode (string): Standby mode, mtu_config (integer): MTU config, group (integer): Indicates the priority group id, updated_at (string): Interface info updated date and time, } interface_sims { imsi (string): IMSI, iccid (string): ICCID, status (string): SIM Status, active (boolean): Indicates if the SIM is active, bandwidthAllowanceMonitor (interface_sims_bandwdith_allowance_monitor): Bandwidth allowance monitor information of the WAN connection or SIM, } interface_sims_bandwdith_allowance_monitor { enable (boolean): Indicates if the bandwidth allowance monitor is enabled, } interface_cellular_signals { rssi (number): Signal Strength in RSSI (dBm), sinr (number): Signal Quality in SINR (dB), rsrp (number): Signal Strength in RSRP (dBm), rsrq (number): Signal Quality in RSRQ (dB), } vlan_interface { vlan_id (integer): VLAN ID, vlan_ip (string): VLAN IP, netmask (string): VLAN netmask, name (string): VLAN name, icmg (boolean): Indicates if the VLAN is managed by InControl, portal_id (integer): Unique identifier of VLAN portal, portal_name (string): Name of the VLAN portal, portal_enabled (boolean): Indicates if the VLAN portal is enabled, } ssid_mac_list { bssid (string): BSSID of the ESSID, essid (string): ESSID, radio (string): Radio band, security (string): the security policy of the SSID, }
{ "resp_code": "", "caller_ref": "", "server_ref": "", "message": "", "data": [ { "id": 0, "group_id": 0, "group_name": "", "sn": "", "name": "", "status": "", "product_id": 0, "fw_ver": "", "last_online": "", "offline_at": "", "first_appear": "", "lan_mac": "", "interfaces": [ { "id": 0, "type": "", "status": "", "last_status": "", "name": "", "ddns_host": "", "ddns_name": "", "ddns_enabled": true, "dns_servers": [ "" ], "ip_status": "", "conn_len": 0, "ip": "", "netmask": "", "is_enable": true, "conn_mode": 0, "port_type": 0, "gateway": "", "mtu": 0.0, "healthcheck": "", "sims": { "imsi": "", "iccid": "", "status": "", "active": true, "bandwidthAllowanceMonitor": { "enable": true } }, "meid_hex": "", "esn": "", "imei": "", "imei_cdf": "", "apn": "", "username": "", "password": "", "dialnum": "", "carrier_name": "", "carrier_settings": "", "s2g3glte": "", "signal_bar": 0, "gobi_data_tech": "", "gobi_band_class_name": "", "gobi_band_2_class_name": "", "cellular_signals": { "rssi": 0.0, "sinr": 0.0, "rsrp": 0.0, "rsrq": 0.0 }, "gobi_band_2_cellular_signals": { "rssi": 0.0, "sinr": 0.0, "rsrp": 0.0, "rsrq": 0.0 }, "cell_id": 0, "adaptor_type": "", "vendor_id": 0, "product_id": 0, "modem_name": "", "modem_manufacturer": "", "status_led": "", "is_overall_up": 0, "standby_state": "", "mtu_state": 0, "healthy_state": 0, "connection_state": 0, "physical_state": 0, "is_backup": 0, "is_quota_exceed": 0, "is_manual_disconnect": 0, "conn_config_method": "", "standby_mode": "", "mtu_config": 0, "group": 0, "updated_at": "" } ], "vlan_interfaces": [ { "vlan_id": 0, "vlan_ip": "", "netmask": "", "name": "", "icmg": true, "portal_id": 0, "portal_name": "", "portal_enabled": true } ], "product_name": "", "product_code": "", "mv": "", "tags": [ "" ], "note": "", "address": "", "expiry_date": "", "sub_expiry_date": "", "prime_expiry_date": "", "prime_type": 0, "expired": true, "sub_expired": true, "ssid_mac_list": [ { "bssid": "", "essid": "", "radio": "", "security": "" } ], "group_type": "", "device_type": "", "last_sync_date": "", "uptime": 0, "uptime_appear": "", "ddns_enabled": true, "ddns_letsencrypt_enabled": true, "onlineStatus": "", "wtp_ip": "", "site_id": "", "pepvpn_peers": 0, "route_isolation": true, "hub_support": true, "dr_support": true, "endpoint_support": true, "mvpn_license": 0 } ] }
Field | Type | Description |
---|---|---|
resp_code | string |
Response code
SUCCESS, INVALID_INPUT, INTERNAL_ERROR, PENDING |
caller_ref | string |
Caller reference identifier, auto generated if not specified
|
server_ref | string |
Server reference identifier, generated on server side
|
message | string |
Response message
|
data | array[device_list_basic_obj] |
Response data object
|
Field | Type | Description |
---|---|---|
id | integer |
Unique identifier of the device
|
group_id | integer |
Unique identifier of the group
|
group_name | string |
Name of the group
|
sn | string |
Device S/N
|
name | string |
Device name
|
status | string |
Device status
online, offline |
product_id | integer |
Unique identifier of the product
|
fw_ver | string |
Firmware version using
|
last_online | string |
Last online date and time
|
offline_at | string |
Last offline date and time
|
first_appear | string |
First appeared date and time
|
lan_mac | string |
LAN MAC address
|
interfaces | array[interface] |
Device interfaces
|
vlan_interfaces | array[vlan_interface] |
VLAN interfaces
|
product_name | string |
Product name
|
product_code | string |
Product code
|
mv | string |
Model variant
|
tags | array[string] |
List of Device tags name
|
note | string |
Note
|
address | string |
Location address
|
expiry_date | string |
Warranty expiry date
|
sub_expiry_date | string |
Subscription expiry date
|
prime_expiry_date | string |
Prime expiry date
|
prime_type | integer |
Prime Type: 1 - with prime subscription, 0 or undefined - without prime subscription
0, 1 |
expired | boolean |
Indicates if the device warranty has expired
|
sub_expired | boolean |
Indicates if the device subscription has expired
|
ssid_mac_list | array[ssid_mac_list] |
SSID mac list
|
group_type | string |
Group type
peplink |
device_type | string |
Device type
|
last_sync_date | string |
Last config applied date and time
|
uptime | integer |
Device up time
|
uptime_appear | string |
Retrieval time of the device up time
|
ddns_enabled | boolean |
Indicates if "Find My Peplink Service" enabled
|
ddns_letsencrypt_enabled | boolean |
Indicates if "Manage Web Admin SSL Certificate" is enabled for "Find My Peplink Service"
|
onlineStatus | string |
Current online status
|
wtp_ip | string |
Last Detected IP
|
site_id | string |
PepVPN Site ID
|
pepvpn_peers | integer |
Maximum number of PepVPN / SpeedFusion Peer Connections
|
route_isolation | boolean |
PepVPN Route Isolation
|
hub_support | boolean | |
dr_support | boolean | |
endpoint_support | boolean | |
mvpn_license | integer |
Field | Type | Description |
---|---|---|
id | integer |
System generated interface identifier
|
type | string |
Interface type
|
status | string |
Interface status for InControl, Connected|Disconnected|Disabled|No SIM Card Detected|No Cable Detected
|
last_status | string |
Wan status, Only exists if the device is offline
|
name | string |
Interface name
|
ddns_host | string |
DDNS host
|
ddns_name | string |
Find My Peplink Address
|
ddns_enabled | boolean |
Indicates if DDNS is enabled
|
dns_servers | array[string] |
List of dns servers
|
ip_status | string | |
conn_len | integer | |
ip | string |
IP
|
netmask | string |
Netmask
|
is_enable | boolean |
Indicates if the interface is enabled
|
conn_mode | integer |
Routing mode
|
port_type | integer |
Port type
|
gateway | string |
Default gateway
|
mtu | number |
MTU
|
healthcheck | string |
Health check method, "nslookup" - DNS Lookup, "pstr" - SmartCheck, "disabled" - Disabled, "ping" - PING, "http" - HTTP
|
sims | interface_sims |
SIMs info
|
meid_hex | string |
MEID DEC
|
esn | string |
ESN
|
imei | string |
IMEI
|
imei_cdf | string |
Cellular Module
|
apn | string |
APN
|
username | string |
Username for APN
|
password | string |
Password for APN
|
dialnum | string |
Dial Number for APN
|
carrier_name | string |
Carrier
|
carrier_settings | string |
Carrier settings
|
s2g3glte | string |
Indicates if the network is "3G", "4G" or "LTE"
|
signal_bar | integer |
Indicates the signal bar level, -1: no signal, 0-5: signal bar level
|
gobi_data_tech | string |
Network
|
gobi_band_class_name | string |
Network band
|
gobi_band_2_class_name | string |
Secondary band
|
cellular_signals | interface_cellular_signals |
Cellular signals
|
gobi_band_2_cellular_signals | interface_cellular_signals |
Cellular signals
|
cell_id | integer |
Cell ID
|
adaptor_type | string |
Modem adaptor type
|
vendor_id | integer |
Modem adaptor vendor ID
|
product_id | integer |
Modem adaptor product ID
|
modem_name | string |
Modem adaptor name
|
modem_manufacturer | string |
Modem adaptor manufacturer
|
status_led | string |
Indicates the interface status in color in InControl
|
is_overall_up | integer | |
standby_state | string |
Standby state, connected|disconnect
|
mtu_state | integer | |
healthy_state | integer | |
connection_state | integer |
Connection state
|
physical_state | integer |
Physical state
|
is_backup | integer | |
is_quota_exceed | integer | |
is_manual_disconnect | integer | |
conn_config_method | string |
Connection Method
|
standby_mode | string |
Standby mode
|
mtu_config | integer |
MTU config
|
group | integer |
Indicates the priority group id
|
updated_at | string |
Interface info updated date and time
|
Field | Type | Description |
---|---|---|
imsi | string |
IMSI
|
iccid | string |
ICCID
|
status | string |
SIM Status
|
active | boolean |
Indicates if the SIM is active
|
bandwidthAllowanceMonitor | interface_sims_bandwdith_allowance_monitor |
Bandwidth allowance monitor information of the WAN connection or SIM
|
Field | Type | Description |
---|---|---|
enable | boolean |
Indicates if the bandwidth allowance monitor is enabled
|
Field | Type | Description |
---|---|---|
rssi | number |
Signal Strength in RSSI (dBm)
|
sinr | number |
Signal Quality in SINR (dB)
|
rsrp | number |
Signal Strength in RSRP (dBm)
|
rsrq | number |
Signal Quality in RSRQ (dB)
|
Field | Type | Description |
---|---|---|
vlan_id | integer |
VLAN ID
|
vlan_ip | string |
VLAN IP
|
netmask | string |
VLAN netmask
|
name | string |
VLAN name
|
icmg | boolean |
Indicates if the VLAN is managed by InControl
|
portal_id | integer |
Unique identifier of VLAN portal
|
portal_name | string |
Name of the VLAN portal
|
portal_enabled | boolean |
Indicates if the VLAN portal is enabled
|
Field | Type | Description |
---|---|---|
bssid | string |
BSSID of the ESSID
|
essid | string |
ESSID
|
radio | string |
Radio band
|
security | string |
the security policy of the SSID
|
Parameters
Response Content Type:
Parameters
text/csv
Parameters
Response Content Type:
Parameters
application/json
Parameters
Response Content Type:
Model Schema
Model | Response Sample | Model Description
[expand] | [collapse]
[expand] | [collapse]
[expand] | [collapse]
Parameters
application/json
Model Schema
Model | Response Sample | Model Description
response { resp_code (string): Response code, caller_ref (string): Caller reference identifier, auto generated if not specified, server_ref (string): Server reference identifier, generated on server side, message (string): Response message, data (array[device]): Response data object, } device { id (integer): Unique identifier of the device, group_id (integer): Unique identifier of the group, group_name (string): Name of the group, sn (string): Device S/N, name (string): Device name, status (string): Device status, usage (number): Current bandwidth usage, tx (number): Current upload usage, rx (number): Current download usage, product_id (integer): Unique identifier of the product, client_count (integer): Current client count, fw_ver (string): Firmware version using, last_online (string): Last online date and time, offline_at (string): Last offline date and time, first_appear (string): First appeared date and time, lan_mac (string): LAN MAC address, config_rollback (boolean): Indicates if the recent change in outbound policy or firewall rules applied from InControl has been rolled back as the device was unable to reach InControl., config_rollback_date (string): Config roll back date and time, ic2_config_apply_locked (boolean): Indicates if the device is "Config Locked" by InControl, outstanding_patch_ids (array[string]): Unique identifier of the outstanding configuration patches, device_config_apply_locked (boolean): Indicates if the device is "Config Locked" by device, sp_default (boolean): Indicates if the active configuration is saved as SP default, product_name (string): Product name, product_code (string): Product code, mv (string): Model variant, tags (array[string]): List of Device tags name, tag_info (array[tag_info]): List of Device tags information, note (string): Note, longitude (number): Location longitude, latitude (number): Location latitude, address (string): Location address, location_timestamp (string): Location recorded time, follow_loc_dev (integer): Device's ID of the followed location device, follow_loc_dev_info (follow_loc_dev_info): Followed location device information, isStatic (boolean): Indicates if the returned location is a static one, expiry_date (string): Warranty expiry date, sub_expiry_date (string): Subscription expiry date, prime_expiry_date (string): Prime expiry date, prime_type (integer): Prime Type: 1 - with prime subscription, 0 or undefined - without prime subscription, expired (boolean): Indicates if the device warranty has expired, sub_expired (boolean): Indicates if the device subscription has expired, gps_support (boolean): Indicates if the device support gps, gps_exist (boolean): Indicates if the device with any gps records, support_ssid_count (number): Supported number of SSIDs, radio_modules (array[radio_module]): Supported radio modules, group_type (string): Group type, device_type (string): Device type, last_sync_date (string): Last config applied date and time, v6_license (string): Indicates if the device has activated firmware 6.x license, uptime (integer): Device up time, uptime_appear (string): Retrieval time of the device up time, fw_pending_trial_round (integer): Firmware update trial count, fw_pending_max_no_of_trial (integer): Maximum number of firmware update trial count, fw_pending_ver (string): Version of the firmware to be updated, fw_pending_schedule_time (string): Scheduled firmware update start time, fw_pending_upgrade_time (string): Actual firmware update time, fw_pending_status (integer): Firmware update status, 1 - active, 0 - inactive, fw_pending_group_time (string): Pending firmware update time in the group's time zone, is_master_device (boolean): Indicates if the device is a master configuration cloning device, fw_managmed (string): (only for device detail call) Indicates if the firmware is managed by organization level, group level or device level, wifi_cfg (string): Indicates the device follows group or device level's SSID settings, or locally managed on the device, ddns_enabled (boolean): Indicates if "Find My Peplink Service" enabled, ddns_available (boolean): Indicates if "Find My Peplink Service" available, ddns_letsencrypt_enabled (boolean): Indicates if "Manage Web Admin SSL Certificate" is enabled for "Find My Peplink Service", ddns_letsencrypt_cert_expiry_date (string): Web Admin SSL certificate expiry date and time, ddns_letsencrypt_apply_date (string): Web Admin SSL certificate apply date and time, onlineStatus (string): Current online status, wtp_ip (string): Last Detected IP, interfaces (array[interface]): Device interfaces, vlan_interfaces (array[vlan_interface]): VLAN interfaces, ssid_profiles (array[ssid_profile]): SSID profiles, ssid_profiles_applied (array[ssid_profiles_applied]): Applied SSID profiles, hardware_version (string): Hardware version, mvpn_version (string): MVPN version, radio_bands (array[radio_band]): Radio bands, loc_display (boolean): Indicates if address displayed on "Location" field in InControl Device Detail Page: true - display address, false - display latitude/longitude, extap_proxy_supported (boolean): Indicates if the device is a AP controller, extap_proxy_enabled (boolean): Indicates if the device is a managed by AP controller, wlan_probe_supported (boolean): Indicates if the device supports "Collecting Wi-Fi Analytics Data", wlan_probe_enabled (boolean): Indicates if the device enabled "Collecting Wi-Fi Analytics Data" in InControl, dpi_supported (boolean): Indicates if the device supports deep packet inspection, dpi_enabled (boolean): Indicates if the device enabled deep packet inspection, low_data_usage_mode (boolean): Indicates if the device enabled low data usage mode, ra_enabled (boolean): Indicates if the device enabled remote assistance, watchdog_enabled (boolean): Indicates if the device enabled hardware watchdog, ra_supported (boolean): Indicates if the device support remote assistance, watchdog_supported (boolean): Indicates if the device support hardware watchdog, ap_router_mode (boolean): Indicates if the device applied router mode, true - router mode, false - bridge mode, ssid_mac_list (array[ssid_mac_list]): SSID mac list, site_id (string): PepVPN Site ID, handshake_port (boolean): (PepVPN / SpeedFusion) Handshake port, refuse_legacy (boolean): (PepVPN / SpeedFusion) Indicates if the device accept connections from legacy firmware, peer_connections (integer): PepVPN / SpeedFusion Peer Connections, pepvpn_peers (integer): Maximum number of PepVPN / SpeedFusion Peer Connections, is_default_password (boolean): Indicates if default password is used in device web admin, is_apply_bulk_config (boolean): Indicates if the device is applied with bulk config, is_wlan_ap_suspended (boolean): Indicates if the device WLAN AP is suspended, is_ap_schedule_enabled (boolean): Indicates if the device AP schedule enabled, is_ha_enabled (boolean): Indicates if high availability enabled, is_ha_slave (boolean): Indicates if the device is a high availability slave unit, ha_role (string): High Availability Preferred Role (master|slave), ha_status (string): High Availability Status, ha_transition_time (string): Last Transition Date and time, periph_status_available (boolean): Indicates if periph status is available, periph_status (periph_status): Periph status, port_status_available (boolean): Indicates if port status is available, port_status (port_status): Port status, gobi_sim_lock_supported (boolean): Indicates if the device support SIM lock, gobi_sim_locks (array[string]): , poe_supported (boolean): Indicates if the device support poe, admin_conf (admin_conf): Admin configuration, outbound_policy_managed (boolean): , firewall_rules_managed (boolean): , is_apply_import_lan (boolean): , is_apply_csv_override (boolean): , is_wlc_enabled (boolean): , mgnt_incontrol_vlan_ip (string): , mgnt_incontrol_vlan (integer): , mgnt_incontrol_vlan_gateway (string): , mgnt_incontrol_vlan_dns (array[string]): , mgnt_incontrol_vlan_connection_type (string): , mgnt_vlan_ip (string): , mgnt_vlans (array[vlan_interface]): , max_lacp_group_support (integer): , max_port_per_lacp_group (integer): , endpoint_support (boolean): , slow_response (boolean): , slow_response_start_time (string): , wlan_mac_list (array[wlan_mac_list]): , slot_module_list (array[slot_module]): List of slot module information, vlan_managed (boolean): (device detail) Indicates if the device has VLAN managed, icmg_mvpn (boolean): , icmg_wan (boolean): Indicates if Device WAN settings is managed by InControl, icmg_schedule_reboot (boolean): Indicates if the device is applying Device Schedule Reboot, icmg_schedule (boolean): Indicates if the device is applying Device Schedule, icmg_wlan (boolean): Indicates if SSID and Radio settings is managed by InControl, icmg_portal (boolean): Indicates if Captive Portal is managed by InControl, icmg_lan (boolean): Indicates if Device LAN IP settings is managed by InControl, icmg_sdswitch (boolean): , icmg_outbound (boolean): Indicates if Outbound Policy managed by InControl, icmg_firewall (boolean): Indicates if Firewall Rules is managed by InControl, icmg_admin (boolean): Indicates if device web admin management is managed by InControl, } tag_info { id (integer): Unique identifier of the device tag, name (string): Device tag name, } follow_loc_dev_info { id (integer): Unique identifier of the followed device, sn (string): S/N of the followed device, name (string): Device name of the followed device, onlineStatus (string): Online status of the followed device, } radio_module { module_id (integer): System generated Wi-Fi radio module identifier, frequency_band (string): Supported radio frequency bands, active_frequency_band (string): The active frequency band, } interface { id (integer): System generated interface identifier, type (string): Interface type, status (string): Interface status for InControl, Connected|Disconnected|Disabled|No SIM Card Detected|No Cable Detected, last_status (string): Wan status, Only exists if the device is offline, name (string): Interface name, ddns_host (string): DDNS host, ddns_name (string): Find My Peplink Address, ddns_enabled (boolean): Indicates if DDNS is enabled, dns_servers (array[string]): List of dns servers, ip_status (string): , conn_len (integer): , ip (string): IP, netmask (string): Netmask, is_enable (boolean): Indicates if the interface is enabled, conn_mode (integer): Routing mode, port_type (integer): Port type, gateway (string): Default gateway, mtu (number): MTU, healthcheck (string): Health check method, "nslookup" - DNS Lookup, "pstr" - SmartCheck, "disabled" - Disabled, "ping" - PING, "http" - HTTP, sims (interface_sims): SIMs info, meid_hex (string): MEID DEC, esn (string): ESN, imei (string): IMEI, imei_cdf (string): Cellular Module, apn (string): APN, username (string): Username for APN, password (string): Password for APN, dialnum (string): Dial Number for APN, carrier_name (string): Carrier, carrier_settings (string): Carrier settings, s2g3glte (string): Indicates if the network is "3G", "4G" or "LTE", signal_bar (integer): Indicates the signal bar level, -1: no signal, 0-5: signal bar level, gobi_data_tech (string): Network, gobi_band_class_name (string): Network band, gobi_band_2_class_name (string): Secondary band, cellular_signals (interface_cellular_signals): Cellular signals, gobi_band_2_cellular_signals (interface_cellular_signals): Cellular signals, cell_id (integer): Cell ID, adaptor_type (string): Modem adaptor type, vendor_id (integer): Modem adaptor vendor ID, product_id (integer): Modem adaptor product ID, modem_name (string): Modem adaptor name, modem_manufacturer (string): Modem adaptor manufacturer, status_led (string): Indicates the interface status in color in InControl, is_overall_up (integer): , standby_state (string): Standby state, connected|disconnect, mtu_state (integer): , healthy_state (integer): , connection_state (integer): Connection state, physical_state (integer): Physical state, is_backup (integer): , is_quota_exceed (integer): , is_manual_disconnect (integer): , conn_config_method (string): Connection Method, standby_mode (string): Standby mode, mtu_config (integer): MTU config, group (integer): Indicates the priority group id, updated_at (string): Interface info updated date and time, } interface_sims { imsi (string): IMSI, iccid (string): ICCID, status (string): SIM Status, active (boolean): Indicates if the SIM is active, bandwidthAllowanceMonitor (interface_sims_bandwdith_allowance_monitor): Bandwidth allowance monitor information of the WAN connection or SIM, } interface_sims_bandwdith_allowance_monitor { enable (boolean): Indicates if the bandwidth allowance monitor is enabled, } interface_cellular_signals { rssi (number): Signal Strength in RSSI (dBm), sinr (number): Signal Quality in SINR (dB), rsrp (number): Signal Strength in RSRP (dBm), rsrq (number): Signal Quality in RSRQ (dB), } vlan_interface { vlan_id (integer): VLAN ID, vlan_ip (string): VLAN IP, netmask (string): VLAN netmask, name (string): VLAN name, icmg (boolean): Indicates if the VLAN is managed by InControl, portal_id (integer): Unique identifier of VLAN portal, portal_name (string): Name of the VLAN portal, portal_enabled (boolean): Indicates if the VLAN portal is enabled, } ssid_profile { tags (array[tag_info]): Device tag selected, exempt_tags (array[tag_info]): Device tag exempted, fast_transition (boolean): Indicates if Fast Transition is enabled, acl_id (integer): Unique identifier of the Access Control List applied, access_control_list (access_control_list): Access Control List, device_select (string): Device Selection, portal_id (integer): Unique identifier of the applied captive portal, access_mode (array[string]): Access mode of the applied captive portal, id (integer): Unique identifier of the SSID profile, enabled (boolean): Indicates if the SSID profile is enabled, ssid (string): SSID, security (string): SSID security type, wep (wep_settings): WEP Security settings, layer2_isolation (boolean): Indicates if Layer 2 Isolation is enabled, mac_filter (string): MAC address filtering type, mac_list (array[string]): MAC Address List, multicast_filter (boolean): Indicates if multicast Filter is enabled, multicast_rate (string): Multicast Rate, broadcast (boolean): Indicates whether SSID is broadcasted, otherwise hidden, icMg (boolean): Indicates if the SSID profile is managed in InControl, vlan_id (integer): VLAN ID, radio_band (string): Radio Band(s) the SSID is available on, radio_select (string): Radio Band selected, 1 - 2.4ghz, 2 - 5ghz, 3 - both, band_steering (string): Band Steering, Default value: 'preferred', igmp_snooping (boolean): Indicates if IGMP snooping is enabled, portal_enabled (boolean): Indicates if captive portal is applied for the SSID profile, portal_url (string): , portal_cacheId (string): , portal_auth (string): , portal_cna_bypass (boolean): , portal_domain_accept (string): , portal_idle_sec (integer): , portal_inactive_timeout (integer): , portal_logout_kick (boolean): , radius_nasid_type (string): NAS-Identifier in RADUIS server settings, radius_nasid_custom (string): NAS-Identifier custom value in RADUIS server settings, bandwidth_control (boolean): , client_bandwidth_upstream (integer): Per client upstream limit in kbps (0: Unlimited) (Pepwave AP only), client_bandwidth_downstream (integer): Per client downstream limit in kbps (0: Unlimited) (Pepwave AP only), bandwidth_upstream (integer): Upstream limit in kbps (0: Unlimited) (Pepwave AP only), bandwidth_downstream (integer): Downstream limit in kbps (0: Unlimited) (Pepwave AP only), block_lan_access (boolean): Indicates if Block LAN Access is enabled (Pepwave AP only), block_custom_subnet (boolean): Indicates if Custom Subnet is applied, block_custom_subnet_list (string): Custom Subnet (Pepwave AP only), block_except (boolean): Indicates if Block Exception is applied, block_except_list (string): Block Exception (Pepwave AP only), block_mvpn (boolean): Indicates Block PepVPN is enabled, client_limit (integer): Maximum number of clients for 2.4 GHz, client_limit_5g (integer): Maximum number of clients for 5 GHz, qos (integer): Network Priority (QoS), 0 - Gold, 1 - Silver, 2 - Bronze, wpa_personal (wpa_personal_settings): WPA/WPA2 Security settings, schedule_id (integer): Device schedule, portal_custom (boolean): Indicates if external captive portal is applied for the SSID profile, radius_servers (array[radius_server]): List of RADIUS Server settings, } access_control_list { id (integer): Unique identifier of the access control list, group_id (integer): Unique identifier of the group, name (string): Name of the access control list, address (array[string]): List of MAC addresses, referenced_by (array[access_control_list_referenced_by]): List of access control list reference by object, Only appears when with_reference=true, } access_control_list_referenced_by { type (string): Type of reference object, id (integer): Unique identifier of the reference object, name (string): Name of the reference object, device_id (integer): Unique identifier of the device, group_id (integer): Unique identifier of the group, } wep_settings { key_format (string): Key Format, key_size (integer): Key size, encrypt_key (string): Encryption key., shared_key_auth (boolean): Indicates whether shared key authentication is enabled, } wpa_personal_settings { psk_enable (boolean): Indicates whether pre-shared key is enabled, shared_key (string): The pre-shared key, shared_key_type (string): Shared Key Option
"static" - Static shared key
"lan_mac" - Last 8 octets of LAN MAC address
"random" - Random, shared_key_random_prefix (string): required when shared_key_type=random, Prefix in generated shared key, shared_key_random_alphas (integer): required when shared_key_type=random, Number of alphabets generated in shared key, shared_key_random_digits (integer): required when shared_key_type=random, Number of digits generated in shared key, regenerate_shared_key (boolean): when update a SSID profile, Indicates if regenerate key is enabled, regenerate_shared_key_device_tags (array[integer]): when update a SSID profile, List of device tags IDs applied for the regenerate key, } radius_server { id (integer): RADIUS server identifier, host (string): Server host name, secret (string): Server secret, auth_port (integer): RADIUS server authentication port, account_port (integer): RADIUS server accounting port, radius_nasid_type (string): NAS-Identifier, Default: device_name, radius_nasid_custom (string): NAS-Identifier custom value, required when radius_nasid_type=custom, } ssid_profiles_applied { id (integer): System generated SSID profile identifier, ssid (string): SSID, group_id (integer): Unique identifier of the group, device_id (integer): Unique identifier of the device, portal_id (integer): Unique identifier of the captive portal/external captive portal, enabled (boolean): Indicates if the ssid profile is enabled, icMg (boolean): Indicates if the ssid profile is managed by InControl, vlan_id (integer): VLAN ID, portal_custom (boolean): Indicates if the portal is external captive portal, wpa_passphrase (string): WPA passphrase, the field would be hidden for read-only users, } radio_band { radio_bands (integer): Unique identifier of the radio band, active_band (string): The active frequency band, txpower (number): Output power, channel (integer): Channel, channel_mode (string): Channel Mode, } ssid_mac_list { bssid (string): BSSID of the ESSID, essid (string): ESSID, radio (string): Radio band, security (string): the security policy of the SSID, } periph_status { cpu_load (usage_data): CPU load, power_state (power_state): Power State, power_usage (usage_data): Power Usage, fan_speed (usage_data): Fan speed, thermal_sensor (temperature): Thermal Sensor, } usage_data { name (string): Name, value (number): Value, total (number): Total, voltage (number): Voltage, current (number): Current, percentage (number): Percentage, active (boolean): Active, } power_state { name (string): Name, connect (boolean): Indicates if the power is connected, } temperature { temperature (number): Temperature, max (number): Maximum, threshold (number): Threshold, min (number): Minimum, } port_status { } admin_conf { managed (boolean): Indicates if device web admin management is enabled, protocol (string): , admin_auth (string): , admin_user_auth (string): , version (integer): , admin_name (string): Admin User Name, admin_password (string): Admin password, admin_readonly_name (string): Read-only User Name, admin_readonly_password (string): Read-only User password, admin_radius_enable (boolean): Indicates if Authentication by RADIUS is enabled, } wlan_mac_list { bssid (string): BSSID of the ESSID, essid (string): ESSID, radio_band (string): Radio band, radio (string): Radio band, security (string): the security policy of the SSID, enabled (boolean): , encryption (string): , portal_id (integer): , } slot_module { slot (integer): Module slot, hw_ver (string): Module hardware version, sn (string): Module S/N, model (string): Module model, product_name (string): Module product name, expiry_date (string): Module expiry date and time, }
{ "resp_code": "", "caller_ref": "", "server_ref": "", "message": "", "data": [ { "id": 0, "group_id": 0, "group_name": "", "sn": "", "name": "", "status": "", "usage": 0.0, "tx": 0.0, "rx": 0.0, "product_id": 0, "client_count": 0, "fw_ver": "", "last_online": "", "offline_at": "", "first_appear": "", "lan_mac": "", "config_rollback": true, "config_rollback_date": "", "ic2_config_apply_locked": true, "outstanding_patch_ids": [ "" ], "device_config_apply_locked": true, "sp_default": true, "product_name": "", "product_code": "", "mv": "", "tags": [ "" ], "tag_info": [ { "id": 0, "name": "" } ], "note": "", "longitude": 0.0, "latitude": 0.0, "address": "", "location_timestamp": "", "follow_loc_dev": 0, "follow_loc_dev_info": { "id": 0, "sn": "", "name": "", "onlineStatus": "" }, "isStatic": true, "expiry_date": "", "sub_expiry_date": "", "prime_expiry_date": "", "prime_type": 0, "expired": true, "sub_expired": true, "gps_support": true, "gps_exist": true, "support_ssid_count": 0.0, "radio_modules": [ { "module_id": 0, "frequency_band": "", "active_frequency_band": "" } ], "group_type": "", "device_type": "", "last_sync_date": "", "v6_license": "", "uptime": 0, "uptime_appear": "", "fw_pending_trial_round": 0, "fw_pending_max_no_of_trial": 0, "fw_pending_ver": "", "fw_pending_schedule_time": "", "fw_pending_upgrade_time": "", "fw_pending_status": 0, "fw_pending_group_time": "", "is_master_device": true, "fw_managmed": "", "wifi_cfg": "", "ddns_enabled": true, "ddns_available": true, "ddns_letsencrypt_enabled": true, "ddns_letsencrypt_cert_expiry_date": "", "ddns_letsencrypt_apply_date": "", "onlineStatus": "", "wtp_ip": "", "interfaces": [ { "id": 0, "type": "", "status": "", "last_status": "", "name": "", "ddns_host": "", "ddns_name": "", "ddns_enabled": true, "dns_servers": [ "" ], "ip_status": "", "conn_len": 0, "ip": "", "netmask": "", "is_enable": true, "conn_mode": 0, "port_type": 0, "gateway": "", "mtu": 0.0, "healthcheck": "", "sims": { "imsi": "", "iccid": "", "status": "", "active": true, "bandwidthAllowanceMonitor": { "enable": true } }, "meid_hex": "", "esn": "", "imei": "", "imei_cdf": "", "apn": "", "username": "", "password": "", "dialnum": "", "carrier_name": "", "carrier_settings": "", "s2g3glte": "", "signal_bar": 0, "gobi_data_tech": "", "gobi_band_class_name": "", "gobi_band_2_class_name": "", "cellular_signals": { "rssi": 0.0, "sinr": 0.0, "rsrp": 0.0, "rsrq": 0.0 }, "gobi_band_2_cellular_signals": { "rssi": 0.0, "sinr": 0.0, "rsrp": 0.0, "rsrq": 0.0 }, "cell_id": 0, "adaptor_type": "", "vendor_id": 0, "product_id": 0, "modem_name": "", "modem_manufacturer": "", "status_led": "", "is_overall_up": 0, "standby_state": "", "mtu_state": 0, "healthy_state": 0, "connection_state": 0, "physical_state": 0, "is_backup": 0, "is_quota_exceed": 0, "is_manual_disconnect": 0, "conn_config_method": "", "standby_mode": "", "mtu_config": 0, "group": 0, "updated_at": "" } ], "vlan_interfaces": [ { "vlan_id": 0, "vlan_ip": "", "netmask": "", "name": "", "icmg": true, "portal_id": 0, "portal_name": "", "portal_enabled": true } ], "ssid_profiles": [ { "tags": [ { "id": 0, "name": "" } ], "exempt_tags": [ { "id": 0, "name": "" } ], "fast_transition": true, "acl_id": 0, "access_control_list": { "id": 0, "group_id": 0, "name": "", "address": [ "" ], "referenced_by": [ { "type": "", "id": 0, "name": "", "device_id": 0, "group_id": 0 } ] }, "device_select": "", "portal_id": 0, "access_mode": [ "" ], "id": 0, "enabled": true, "ssid": "", "security": "", "wep": { "key_format": "", "key_size": 0, "encrypt_key": "", "shared_key_auth": true }, "layer2_isolation": true, "mac_filter": "", "mac_list": [ "" ], "multicast_filter": true, "multicast_rate": "", "broadcast": true, "icMg": true, "vlan_id": 0, "radio_band": "", "radio_select": "", "band_steering": "", "igmp_snooping": true, "portal_enabled": true, "portal_url": "", "portal_cacheId": "", "portal_auth": "", "portal_cna_bypass": true, "portal_domain_accept": "", "portal_idle_sec": 0, "portal_inactive_timeout": 0, "portal_logout_kick": true, "radius_nasid_type": "", "radius_nasid_custom": "", "bandwidth_control": true, "client_bandwidth_upstream": 0, "client_bandwidth_downstream": 0, "bandwidth_upstream": 0, "bandwidth_downstream": 0, "block_lan_access": true, "block_custom_subnet": true, "block_custom_subnet_list": "", "block_except": true, "block_except_list": "", "block_mvpn": true, "client_limit": 0, "client_limit_5g": 0, "qos": 0, "wpa_personal": { "psk_enable": true, "shared_key": "", "shared_key_type": "", "shared_key_random_prefix": "", "shared_key_random_alphas": 0, "shared_key_random_digits": 0, "regenerate_shared_key": true, "regenerate_shared_key_device_tags": [ 0 ] }, "schedule_id": 0, "portal_custom": true, "radius_servers": [ { "id": 0, "host": "", "secret": "", "auth_port": 0, "account_port": 0, "radius_nasid_type": "", "radius_nasid_custom": "" } ] } ], "ssid_profiles_applied": [ { "id": 0, "ssid": "", "group_id": 0, "device_id": 0, "portal_id": 0, "enabled": true, "icMg": true, "vlan_id": 0, "portal_custom": true, "wpa_passphrase": "" } ], "hardware_version": "", "mvpn_version": "", "radio_bands": [ { "radio_bands": 0, "active_band": "", "txpower": 0.0, "channel": 0, "channel_mode": "" } ], "loc_display": true, "extap_proxy_supported": true, "extap_proxy_enabled": true, "wlan_probe_supported": true, "wlan_probe_enabled": true, "dpi_supported": true, "dpi_enabled": true, "low_data_usage_mode": true, "ra_enabled": true, "watchdog_enabled": true, "ra_supported": true, "watchdog_supported": true, "ap_router_mode": true, "ssid_mac_list": [ { "bssid": "", "essid": "", "radio": "", "security": "" } ], "site_id": "", "handshake_port": true, "refuse_legacy": true, "peer_connections": 0, "pepvpn_peers": 0, "is_default_password": true, "is_apply_bulk_config": true, "is_wlan_ap_suspended": true, "is_ap_schedule_enabled": true, "is_ha_enabled": true, "is_ha_slave": true, "ha_role": "", "ha_status": "", "ha_transition_time": "", "periph_status_available": true, "periph_status": { "cpu_load": { "name": "", "value": 0.0, "total": 0.0, "voltage": 0.0, "current": 0.0, "percentage": 0.0, "active": true }, "power_state": { "name": "", "connect": true }, "power_usage": { "name": "", "value": 0.0, "total": 0.0, "voltage": 0.0, "current": 0.0, "percentage": 0.0, "active": true }, "fan_speed": { "name": "", "value": 0.0, "total": 0.0, "voltage": 0.0, "current": 0.0, "percentage": 0.0, "active": true }, "thermal_sensor": { "temperature": 0.0, "max": 0.0, "threshold": 0.0, "min": 0.0 } }, "port_status_available": true, "port_status": {}, "gobi_sim_lock_supported": true, "gobi_sim_locks": [ "" ], "poe_supported": true, "admin_conf": { "managed": true, "protocol": "", "admin_auth": "", "admin_user_auth": "", "version": 0, "admin_name": "", "admin_password": "", "admin_readonly_name": "", "admin_readonly_password": "", "admin_radius_enable": true }, "outbound_policy_managed": true, "firewall_rules_managed": true, "is_apply_import_lan": true, "is_apply_csv_override": true, "is_wlc_enabled": true, "mgnt_incontrol_vlan_ip": "", "mgnt_incontrol_vlan": 0, "mgnt_incontrol_vlan_gateway": "", "mgnt_incontrol_vlan_dns": [ "" ], "mgnt_incontrol_vlan_connection_type": "", "mgnt_vlan_ip": "", "mgnt_vlans": [ { "vlan_id": 0, "vlan_ip": "", "netmask": "", "name": "", "icmg": true, "portal_id": 0, "portal_name": "", "portal_enabled": true } ], "max_lacp_group_support": 0, "max_port_per_lacp_group": 0, "endpoint_support": true, "slow_response": true, "slow_response_start_time": "", "wlan_mac_list": [ { "bssid": "", "essid": "", "radio_band": "", "radio": "", "security": "", "enabled": true, "encryption": "", "portal_id": 0 } ], "slot_module_list": [ { "slot": 0, "hw_ver": "", "sn": "", "model": "", "product_name": "", "expiry_date": "" } ], "vlan_managed": true, "icmg_mvpn": true, "icmg_wan": true, "icmg_schedule_reboot": true, "icmg_schedule": true, "icmg_wlan": true, "icmg_portal": true, "icmg_lan": true, "icmg_sdswitch": true, "icmg_outbound": true, "icmg_firewall": true, "icmg_admin": true } ] }
Field | Type | Description |
---|---|---|
resp_code | string |
Response code
SUCCESS, INVALID_INPUT, INTERNAL_ERROR, PENDING |
caller_ref | string |
Caller reference identifier, auto generated if not specified
|
server_ref | string |
Server reference identifier, generated on server side
|
message | string |
Response message
|
data | array[device] |
Response data object
|
Field | Type | Description |
---|---|---|
id | integer |
Unique identifier of the device
|
group_id | integer |
Unique identifier of the group
|
group_name | string |
Name of the group
|
sn | string |
Device S/N
|
name | string |
Device name
|
status | string |
Device status
online, offline |
usage | number |
Current bandwidth usage
|
tx | number |
Current upload usage
|
rx | number |
Current download usage
|
product_id | integer |
Unique identifier of the product
|
client_count | integer |
Current client count
|
fw_ver | string |
Firmware version using
|
last_online | string |
Last online date and time
|
offline_at | string |
Last offline date and time
|
first_appear | string |
First appeared date and time
|
lan_mac | string |
LAN MAC address
|
config_rollback | boolean |
Indicates if the recent change in outbound policy or firewall rules applied from InControl has been rolled back as the device was unable to reach InControl.
|
config_rollback_date | string |
Config roll back date and time
|
ic2_config_apply_locked | boolean |
Indicates if the device is "Config Locked" by InControl
|
outstanding_patch_ids | array[string] |
Unique identifier of the outstanding configuration patches
|
device_config_apply_locked | boolean |
Indicates if the device is "Config Locked" by device
|
sp_default | boolean |
Indicates if the active configuration is saved as SP default
|
product_name | string |
Product name
|
product_code | string |
Product code
|
mv | string |
Model variant
|
tags | array[string] |
List of Device tags name
|
tag_info | array[tag_info] |
List of Device tags information
|
note | string |
Note
|
longitude | number |
Location longitude
|
latitude | number |
Location latitude
|
address | string |
Location address
|
location_timestamp | string |
Location recorded time
|
follow_loc_dev | integer |
Device's ID of the followed location device
|
follow_loc_dev_info | follow_loc_dev_info |
Followed location device information
|
isStatic | boolean |
Indicates if the returned location is a static one
|
expiry_date | string |
Warranty expiry date
|
sub_expiry_date | string |
Subscription expiry date
|
prime_expiry_date | string |
Prime expiry date
|
prime_type | integer |
Prime Type: 1 - with prime subscription, 0 or undefined - without prime subscription
0, 1 |
expired | boolean |
Indicates if the device warranty has expired
|
sub_expired | boolean |
Indicates if the device subscription has expired
|
gps_support | boolean |
Indicates if the device support gps
|
gps_exist | boolean |
Indicates if the device with any gps records
|
support_ssid_count | number |
Supported number of SSIDs
|
radio_modules | array[radio_module] |
Supported radio modules
|
group_type | string |
Group type
peplink |
device_type | string |
Device type
|
last_sync_date | string |
Last config applied date and time
|
v6_license | string |
Indicates if the device has activated firmware 6.x license
enabled, disabled |
uptime | integer |
Device up time
|
uptime_appear | string |
Retrieval time of the device up time
|
fw_pending_trial_round | integer |
Firmware update trial count
|
fw_pending_max_no_of_trial | integer |
Maximum number of firmware update trial count
|
fw_pending_ver | string |
Version of the firmware to be updated
|
fw_pending_schedule_time | string |
Scheduled firmware update start time
|
fw_pending_upgrade_time | string |
Actual firmware update time
|
fw_pending_status | integer |
Firmware update status, 1 - active, 0 - inactive
0, 1 |
fw_pending_group_time | string |
Pending firmware update time in the group's time zone
|
is_master_device | boolean |
Indicates if the device is a master configuration cloning device
|
fw_managmed | string |
(only for device detail call) Indicates if the firmware is managed by organization level, group level or device level
|
wifi_cfg | string |
Indicates the device follows group or device level's SSID settings, or locally managed on the device
group, device, not_managed |
ddns_enabled | boolean |
Indicates if "Find My Peplink Service" enabled
|
ddns_available | boolean |
Indicates if "Find My Peplink Service" available
|
ddns_letsencrypt_enabled | boolean |
Indicates if "Manage Web Admin SSL Certificate" is enabled for "Find My Peplink Service"
|
ddns_letsencrypt_cert_expiry_date | string |
Web Admin SSL certificate expiry date and time
|
ddns_letsencrypt_apply_date | string |
Web Admin SSL certificate apply date and time
|
onlineStatus | string |
Current online status
|
wtp_ip | string |
Last Detected IP
|
interfaces | array[interface] |
Device interfaces
|
vlan_interfaces | array[vlan_interface] |
VLAN interfaces
|
ssid_profiles | array[ssid_profile] |
SSID profiles
|
ssid_profiles_applied | array[ssid_profiles_applied] |
Applied SSID profiles
|
hardware_version | string |
Hardware version
|
mvpn_version | string |
MVPN version
|
radio_bands | array[radio_band] |
Radio bands
|
loc_display | boolean |
Indicates if address displayed on "Location" field in InControl Device Detail Page: true - display address, false - display latitude/longitude
|
extap_proxy_supported | boolean |
Indicates if the device is a AP controller
|
extap_proxy_enabled | boolean |
Indicates if the device is a managed by AP controller
|
wlan_probe_supported | boolean |
Indicates if the device supports "Collecting Wi-Fi Analytics Data"
|
wlan_probe_enabled | boolean |
Indicates if the device enabled "Collecting Wi-Fi Analytics Data" in InControl
|
dpi_supported | boolean |
Indicates if the device supports deep packet inspection
|
dpi_enabled | boolean |
Indicates if the device enabled deep packet inspection
|
low_data_usage_mode | boolean |
Indicates if the device enabled low data usage mode
|
ra_enabled | boolean |
Indicates if the device enabled remote assistance
2.8.3 |
watchdog_enabled | boolean |
Indicates if the device enabled hardware watchdog
2.8.3 |
ra_supported | boolean |
Indicates if the device support remote assistance
2.8.3 |
watchdog_supported | boolean |
Indicates if the device support hardware watchdog
2.8.3 |
ap_router_mode | boolean |
Indicates if the device applied router mode, true - router mode, false - bridge mode
|
ssid_mac_list | array[ssid_mac_list] |
SSID mac list
|
site_id | string |
PepVPN Site ID
|
handshake_port | boolean |
(PepVPN / SpeedFusion) Handshake port
|
refuse_legacy | boolean |
(PepVPN / SpeedFusion) Indicates if the device accept connections from legacy firmware
|
peer_connections | integer |
PepVPN / SpeedFusion Peer Connections
|
pepvpn_peers | integer |
Maximum number of PepVPN / SpeedFusion Peer Connections
|
is_default_password | boolean |
Indicates if default password is used in device web admin
|
is_apply_bulk_config | boolean |
Indicates if the device is applied with bulk config
|
is_wlan_ap_suspended | boolean |
Indicates if the device WLAN AP is suspended
|
is_ap_schedule_enabled | boolean |
Indicates if the device AP schedule enabled
|
is_ha_enabled | boolean |
Indicates if high availability enabled
|
is_ha_slave | boolean |
Indicates if the device is a high availability slave unit
|
ha_role | string |
High Availability Preferred Role (master|slave)
|
ha_status | string |
High Availability Status
|
ha_transition_time | string |
Last Transition Date and time
|
periph_status_available | boolean |
Indicates if periph status is available
|
periph_status | periph_status |
Periph status
|
port_status_available | boolean |
Indicates if port status is available
|
port_status | port_status |
Port status
|
gobi_sim_lock_supported | boolean |
Indicates if the device support SIM lock
|
gobi_sim_locks | array[string] | |
poe_supported | boolean |
Indicates if the device support poe
|
admin_conf | admin_conf |
Admin configuration
|
outbound_policy_managed | boolean | |
firewall_rules_managed | boolean | |
is_apply_import_lan | boolean | |
is_apply_csv_override | boolean | |
is_wlc_enabled | boolean | |
mgnt_incontrol_vlan_ip | string | |
mgnt_incontrol_vlan | integer | |
mgnt_incontrol_vlan_gateway | string | |
mgnt_incontrol_vlan_dns | array[string] | |
mgnt_incontrol_vlan_connection_type | string | |
mgnt_vlan_ip | string | |
mgnt_vlans | array[vlan_interface] | |
max_lacp_group_support | integer | |
max_port_per_lacp_group | integer | |
endpoint_support | boolean | |
slow_response | boolean | |
slow_response_start_time | string | |
wlan_mac_list | array[wlan_mac_list] | |
slot_module_list | array[slot_module] |
List of slot module information
|
vlan_managed | boolean |
(device detail) Indicates if the device has VLAN managed
|
icmg_mvpn | boolean | |
icmg_wan | boolean |
Indicates if Device WAN settings is managed by InControl
|
icmg_schedule_reboot | boolean |
Indicates if the device is applying Device Schedule Reboot
|
icmg_schedule | boolean |
Indicates if the device is applying Device Schedule
|
icmg_wlan | boolean |
Indicates if SSID and Radio settings is managed by InControl
|
icmg_portal | boolean |
Indicates if Captive Portal is managed by InControl
|
icmg_lan | boolean |
Indicates if Device LAN IP settings is managed by InControl
|
icmg_sdswitch | boolean | |
icmg_outbound | boolean |
Indicates if Outbound Policy managed by InControl
|
icmg_firewall | boolean |
Indicates if Firewall Rules is managed by InControl
|
icmg_admin | boolean |
Indicates if device web admin management is managed by InControl
|
Field | Type | Description |
---|---|---|
id | integer |
Unique identifier of the device tag
|
name | string |
Device tag name
|
Field | Type | Description |
---|---|---|
id | integer |
Unique identifier of the followed device
|
sn | string |
S/N of the followed device
|
name | string |
Device name of the followed device
|
onlineStatus | string |
Online status of the followed device
|
Field | Type | Description |
---|---|---|
module_id | integer |
System generated Wi-Fi radio module identifier
|
frequency_band | string |
Supported radio frequency bands
|
active_frequency_band | string |
The active frequency band
|
Field | Type | Description |
---|---|---|
id | integer |
System generated interface identifier
|
type | string |
Interface type
|
status | string |
Interface status for InControl, Connected|Disconnected|Disabled|No SIM Card Detected|No Cable Detected
|
last_status | string |
Wan status, Only exists if the device is offline
|
name | string |
Interface name
|
ddns_host | string |
DDNS host
|
ddns_name | string |
Find My Peplink Address
|
ddns_enabled | boolean |
Indicates if DDNS is enabled
|
dns_servers | array[string] |
List of dns servers
|
ip_status | string | |
conn_len | integer | |
ip | string |
IP
|
netmask | string |
Netmask
|
is_enable | boolean |
Indicates if the interface is enabled
|
conn_mode | integer |
Routing mode
|
port_type | integer |
Port type
|
gateway | string |
Default gateway
|
mtu | number |
MTU
|
healthcheck | string |
Health check method, "nslookup" - DNS Lookup, "pstr" - SmartCheck, "disabled" - Disabled, "ping" - PING, "http" - HTTP
|
sims | interface_sims |
SIMs info
|
meid_hex | string |
MEID DEC
|
esn | string |
ESN
|
imei | string |
IMEI
|
imei_cdf | string |
Cellular Module
|
apn | string |
APN
|
username | string |
Username for APN
|
password | string |
Password for APN
|
dialnum | string |
Dial Number for APN
|
carrier_name | string |
Carrier
|
carrier_settings | string |
Carrier settings
|
s2g3glte | string |
Indicates if the network is "3G", "4G" or "LTE"
|
signal_bar | integer |
Indicates the signal bar level, -1: no signal, 0-5: signal bar level
|
gobi_data_tech | string |
Network
|
gobi_band_class_name | string |
Network band
|
gobi_band_2_class_name | string |
Secondary band
|
cellular_signals | interface_cellular_signals |
Cellular signals
|
gobi_band_2_cellular_signals | interface_cellular_signals |
Cellular signals
|
cell_id | integer |
Cell ID
|
adaptor_type | string |
Modem adaptor type
|
vendor_id | integer |
Modem adaptor vendor ID
|
product_id | integer |
Modem adaptor product ID
|
modem_name | string |
Modem adaptor name
|
modem_manufacturer | string |
Modem adaptor manufacturer
|
status_led | string |
Indicates the interface status in color in InControl
|
is_overall_up | integer | |
standby_state | string |
Standby state, connected|disconnect
|
mtu_state | integer | |
healthy_state | integer | |
connection_state | integer |
Connection state
|
physical_state | integer |
Physical state
|
is_backup | integer | |
is_quota_exceed | integer | |
is_manual_disconnect | integer | |
conn_config_method | string |
Connection Method
|
standby_mode | string |
Standby mode
|
mtu_config | integer |
MTU config
|
group | integer |
Indicates the priority group id
|
updated_at | string |
Interface info updated date and time
|
Field | Type | Description |
---|---|---|
imsi | string |
IMSI
|
iccid | string |
ICCID
|
status | string |
SIM Status
|
active | boolean |
Indicates if the SIM is active
|
bandwidthAllowanceMonitor | interface_sims_bandwdith_allowance_monitor |
Bandwidth allowance monitor information of the WAN connection or SIM
|
Field | Type | Description |
---|---|---|
enable | boolean |
Indicates if the bandwidth allowance monitor is enabled
|
Field | Type | Description |
---|---|---|
rssi | number |
Signal Strength in RSSI (dBm)
|
sinr | number |
Signal Quality in SINR (dB)
|
rsrp | number |
Signal Strength in RSRP (dBm)
|
rsrq | number |
Signal Quality in RSRQ (dB)
|
Field | Type | Description |
---|---|---|
vlan_id | integer |
VLAN ID
|
vlan_ip | string |
VLAN IP
|
netmask | string |
VLAN netmask
|
name | string |
VLAN name
|
icmg | boolean |
Indicates if the VLAN is managed by InControl
|
portal_id | integer |
Unique identifier of VLAN portal
|
portal_name | string |
Name of the VLAN portal
|
portal_enabled | boolean |
Indicates if the VLAN portal is enabled
|
Field | Type | Description |
---|---|---|
tags | array[tag_info] |
Device tag selected
|
exempt_tags | array[tag_info] |
Device tag exempted
|
fast_transition | boolean |
Indicates if Fast Transition is enabled
|
acl_id | integer |
Unique identifier of the Access Control List applied
|
access_control_list | access_control_list |
Access Control List
|
device_select | string |
Device Selection
disable, enable, exempt |
portal_id | integer |
Unique identifier of the applied captive portal
|
access_mode | array[string] |
Access mode of the applied captive portal
|
id | integer |
Unique identifier of the SSID profile
|
enabled | boolean |
Indicates if the SSID profile is enabled
|
ssid | string |
SSID
|
security | string |
SSID security type
open, wpa_wpa2_personal, wpa_wpa2_enterprise |
wep | wep_settings |
WEP Security settings
|
layer2_isolation | boolean |
Indicates if Layer 2 Isolation is enabled
|
mac_filter | string |
MAC address filtering type
none, deny, allow |
mac_list | array[string] |
MAC Address List
|
multicast_filter | boolean |
Indicates if multicast Filter is enabled
|
multicast_rate | string |
Multicast Rate
mcs0, mcs1, mcs2, mcs3, mcs4, mcs5, mcs6, mcs7 |
broadcast | boolean |
Indicates whether SSID is broadcasted, otherwise hidden
|
icMg | boolean |
Indicates if the SSID profile is managed in InControl
|
vlan_id | integer |
VLAN ID
|
radio_band | string |
Radio Band(s) the SSID is available on
2_4ghz, 5ghz, dual |
radio_select | string |
Radio Band selected, 1 - 2.4ghz, 2 - 5ghz, 3 - both
|
band_steering | string |
Band Steering, Default value: 'preferred'
disable, preferred, forced |
igmp_snooping | boolean |
Indicates if IGMP snooping is enabled
|
portal_enabled | boolean |
Indicates if captive portal is applied for the SSID profile
|
portal_url | string | |
portal_cacheId | string | |
portal_auth | string | |
portal_cna_bypass | boolean | |
portal_domain_accept | string | |
portal_idle_sec | integer | |
portal_inactive_timeout | integer | |
portal_logout_kick | boolean | |
radius_nasid_type | string |
NAS-Identifier in RADUIS server settings
device_name, lan_mac, sn, custom |
radius_nasid_custom | string |
NAS-Identifier custom value in RADUIS server settings
|
bandwidth_control | boolean | |
client_bandwidth_upstream | integer |
Per client upstream limit in kbps (0: Unlimited) (Pepwave AP only)
|
client_bandwidth_downstream | integer |
Per client downstream limit in kbps (0: Unlimited) (Pepwave AP only)
|
bandwidth_upstream | integer |
Upstream limit in kbps (0: Unlimited) (Pepwave AP only)
|
bandwidth_downstream | integer |
Downstream limit in kbps (0: Unlimited) (Pepwave AP only)
|
block_lan_access | boolean |
Indicates if Block LAN Access is enabled (Pepwave AP only)
|
block_custom_subnet | boolean |
Indicates if Custom Subnet is applied
|
block_custom_subnet_list | string |
Custom Subnet (Pepwave AP only)
|
block_except | boolean |
Indicates if Block Exception is applied
|
block_except_list | string |
Block Exception (Pepwave AP only)
|
block_mvpn | boolean |
Indicates Block PepVPN is enabled
|
client_limit | integer |
Maximum number of clients for 2.4 GHz
|
client_limit_5g | integer |
Maximum number of clients for 5 GHz
|
qos | integer |
Network Priority (QoS), 0 - Gold, 1 - Silver, 2 - Bronze
|
wpa_personal | wpa_personal_settings |
WPA/WPA2 Security settings
|
schedule_id | integer |
Device schedule
|
portal_custom | boolean |
Indicates if external captive portal is applied for the SSID profile
|
radius_servers | array[radius_server] |
List of RADIUS Server settings
|
Field | Type | Description |
---|---|---|
id | integer |
Unique identifier of the access control list
|
group_id | integer |
Unique identifier of the group
|
name | string |
Name of the access control list
|
address | array[string] |
List of MAC addresses
|
referenced_by | array[access_control_list_referenced_by] |
List of access control list reference by object, Only appears when with_reference=true
|
Field | Type | Description |
---|---|---|
type | string |
Type of reference object
firewall, outbound, ssid, portal, custom_portal |
id | integer |
Unique identifier of the reference object
|
name | string |
Name of the reference object
|
device_id | integer |
Unique identifier of the device
|
group_id | integer |
Unique identifier of the group
|
Field | Type | Description |
---|---|---|
key_format | string |
Key Format
ASCII, HEX |
key_size | integer |
Key size
|
encrypt_key | string |
Encryption key.
|
shared_key_auth | boolean |
Indicates whether shared key authentication is enabled
|
Field | Type | Description |
---|---|---|
psk_enable | boolean |
Indicates whether pre-shared key is enabled
|
shared_key | string |
The pre-shared key
|
shared_key_type | string |
Shared Key Option
"static" - Static shared key "lan_mac" - Last 8 octets of LAN MAC address "random" - Random static, lan_mac, random |
shared_key_random_prefix | string |
required when shared_key_type=random, Prefix in generated shared key
|
shared_key_random_alphas | integer |
required when shared_key_type=random, Number of alphabets generated in shared key
|
shared_key_random_digits | integer |
required when shared_key_type=random, Number of digits generated in shared key
|
regenerate_shared_key | boolean |
when update a SSID profile, Indicates if regenerate key is enabled
|
regenerate_shared_key_device_tags | array[integer] |
when update a SSID profile, List of device tags IDs applied for the regenerate key
|
Field | Type | Description |
---|---|---|
id | integer |
RADIUS server identifier
|
host | string |
Server host name
|
secret | string |
Server secret
|
auth_port | integer |
RADIUS server authentication port
|
account_port | integer |
RADIUS server accounting port
|
radius_nasid_type | string |
NAS-Identifier, Default: device_name
device_name, sn, lan_mac, custom |
radius_nasid_custom | string |
NAS-Identifier custom value, required when radius_nasid_type=custom
|
Field | Type | Description |
---|---|---|
id | integer |
System generated SSID profile identifier
|
ssid | string |
SSID
|
group_id | integer |
Unique identifier of the group
|
device_id | integer |
Unique identifier of the device
|
portal_id | integer |
Unique identifier of the captive portal/external captive portal
|
enabled | boolean |
Indicates if the ssid profile is enabled
|
icMg | boolean |
Indicates if the ssid profile is managed by InControl
|
vlan_id | integer |
VLAN ID
|
portal_custom | boolean |
Indicates if the portal is external captive portal
|
wpa_passphrase | string |
WPA passphrase, the field would be hidden for read-only users
|
Field | Type | Description |
---|---|---|
radio_bands | integer |
Unique identifier of the radio band
|
active_band | string |
The active frequency band
|
txpower | number |
Output power
|
channel | integer |
Channel
|
channel_mode | string |
Channel Mode
|
Field | Type | Description |
---|---|---|
bssid | string |
BSSID of the ESSID
|
essid | string |
ESSID
|
radio | string |
Radio band
|
security | string |
the security policy of the SSID
|
Field | Type | Description |
---|---|---|
cpu_load | usage_data |
CPU load
|
power_state | power_state |
Power State
|
power_usage | usage_data |
Power Usage
|
fan_speed | usage_data |
Fan speed
|
thermal_sensor | temperature |
Thermal Sensor
|
Field | Type | Description |
---|---|---|
name | string |
Name
|
value | number |
Value
|
total | number |
Total
|
voltage | number |
Voltage
|
current | number |
Current
|
percentage | number |
Percentage
|
active | boolean |
Active
|
Field | Type | Description |
---|---|---|
name | string |
Name
|
connect | boolean |
Indicates if the power is connected
|
Field | Type | Description |
---|---|---|
temperature | number |
Temperature
|
max | number |
Maximum
|
threshold | number |
Threshold
|
min | number |
Minimum
|
Field | Type | Description |
---|
Field | Type | Description |
---|---|---|
managed | boolean |
Indicates if device web admin management is enabled
|
protocol | string | |
admin_auth | string | |
admin_user_auth | string | |
version | integer | |
admin_name | string |
Admin User Name
|
admin_password | string |
Admin password
|
admin_readonly_name | string |
Read-only User Name
|
admin_readonly_password | string |
Read-only User password
|
admin_radius_enable | boolean |
Indicates if Authentication by RADIUS is enabled
|
Field | Type | Description |
---|---|---|
bssid | string |
BSSID of the ESSID
|
essid | string |
ESSID
|
radio_band | string |
Radio band
|
radio | string |
Radio band
|
security | string |
the security policy of the SSID
|
enabled | boolean | |
encryption | string | |
portal_id | integer |
Field | Type | Description |
---|---|---|
slot | integer |
Module slot
|
hw_ver | string |
Module hardware version
|
sn | string |
Module S/N
|
model | string |
Module model
|
product_name | string |
Module product name
|
expiry_date | string |
Module expiry date and time
|
Parameters
Since:
Response Content Type:
Parameters
2.8.2
Response Content Type:
application/json
Parameters
Request Content Type:
Response Content Type:
Parameters
application/x-www-form-urlencoded
Response Content Type:
application/json
Parameters
Request Content Type:
Response Content Type:
Model Schema
Model | Request Sample | Response Sample | Model Description
[expand] | [collapse]
[expand] | [collapse]
[expand] | [collapse]
Parameters
application/json
Response Content Type:
application/json
Model Schema
Model | Request Sample | Response Sample | Model Description
request { data (device_tags_data): Request data object, } device_tags_data { device_ids (array[integer]): Device identifiers, tag_names (array[string]): Device tags, } response { resp_code (string): Response code, caller_ref (string): Caller reference identifier, auto generated if not specified, server_ref (string): Server reference identifier, generated on server side, message (string): Response message, data (): Response data object, }
{ "resp_code": "", "caller_ref": "", "server_ref": "", "message": "" }
Field | Type | Description |
---|---|---|
data | device_tags_data |
Request data object
|
Field | Type | Description |
---|---|---|
device_ids | array[integer] |
Device identifiers
|
tag_names | array[string] |
Device tags
|
Field | Type | Description |
---|---|---|
resp_code | string |
Response code
SUCCESS, INVALID_INPUT, INTERNAL_ERROR, PENDING |
caller_ref | string |
Caller reference identifier, auto generated if not specified
|
server_ref | string |
Server reference identifier, generated on server side
|
message | string |
Response message
|
data |
Response data object
|
Parameters
Request Content Type:
Response Content Type:
Model Schema
Model | Request Sample | Response Sample | Model Description
[expand] | [collapse]
[expand] | [collapse]
[expand] | [collapse]
Parameters
application/json
Response Content Type:
application/json
Model Schema
Model | Request Sample | Response Sample | Model Description
request { data (device_tags_data): Request data object, } device_tags_data { device_ids (array[integer]): Device identifiers, tag_names (array[string]): Device tags, } response { resp_code (string): Response code, caller_ref (string): Caller reference identifier, auto generated if not specified, server_ref (string): Server reference identifier, generated on server side, message (string): Response message, data (): Response data object, }
{ "resp_code": "", "caller_ref": "", "server_ref": "", "message": "" }
Field | Type | Description |
---|---|---|
data | device_tags_data |
Request data object
|
Field | Type | Description |
---|---|---|
device_ids | array[integer] |
Device identifiers
|
tag_names | array[string] |
Device tags
|
Field | Type | Description |
---|---|---|
resp_code | string |
Response code
SUCCESS, INVALID_INPUT, INTERNAL_ERROR, PENDING |
caller_ref | string |
Caller reference identifier, auto generated if not specified
|
server_ref | string |
Server reference identifier, generated on server side
|
message | string |
Response message
|
data |
Response data object
|
Parameters
Since:
Request Content Type:
Response Content Type:
Model Schema
Model | Request Sample | Response Sample | Model Description
[expand] | [collapse]
[expand] | [collapse]
[expand] | [collapse]
[expand] | [collapse]
Parameters
2.6.1
Request Content Type:
application/json
Response Content Type:
application/json
Model Schema
Model | Request Sample | Response Sample | Model Description
request { data (create_group_data): Request data object, } create_group_data { name (string): Name of the group, note (string): Description of the group, country (string): Static location country, address (string): Static location address, longitude (number): Static location longitude, latitude (number): Static location latitude, timezone_id (string): Timezone, clone_network_id (integer): ID of the group that config shall be cloned from, clone_ssid (boolean): True: to clone SSID profiles, clone_vlan (boolean): True: to clone VLAN networks, clone_captive_portal (boolean): True: to clone captive portal profiles, clone_device_schedule (boolean): True: to clone device schedules, schedule_reboot_enabled (boolean): True: Reboot schedule managed by IC2. False: Follow existing reboot schedule setting in device, apply_timezone (boolean): Default True: Devices follow this time zone setting, clone_firewall_rule (boolean): True: to clone firewall rules, clone_outbound_policy (boolean): True: to clone outbound policies, } response { resp_code (string): Response code, caller_ref (string): Caller reference identifier, auto generated if not specified, server_ref (string): Server reference identifier, generated on server side, message (string): Response message, data (): Response data object, }
{ "data": { "name": "", "note": "", "country": "", "address": "", "longitude": 0.0, "latitude": 0.0, "timezone_id": "", "clone_network_id": 0, "clone_ssid": true, "clone_vlan": true, "clone_captive_portal": true, "clone_device_schedule": true, "schedule_reboot_enabled": true, "apply_timezone": true, "clone_firewall_rule": true, "clone_outbound_policy": true } }
{ "resp_code": "", "caller_ref": "", "server_ref": "", "message": "" }
Field | Type | Description |
---|---|---|
data | create_group_data |
Request data object
|
Field | Type | Description |
---|---|---|
name | string |
Name of the group
|
note | string |
Description of the group
|
country | string |
Static location country
|
address | string |
Static location address
|
longitude | number |
Static location longitude
|
latitude | number |
Static location latitude
|
timezone_id | string |
Timezone
Etc/GMT+12, Etc/GMT+11, Pacific/Honolulu, America/Anchorage, America/Los_Angeles, America/Tijuana, America/Phoenix, America/Denver, America/Chihuahua, America/Costa_Rica, America/Regina, America/Chicago, America/Mexico_City, America/Bogota, America/New_York, America/Indiana/Indianapolis, America/Caracas, America/Halifax, America/Santiago, America/La_Paz, America/Cuiaba, America/Asuncion, America/St_Johns, America/Sao_Paulo, America/Bahia, America/Argentina/Buenos_Aires, America/Montevideo, America/Godthab, America/Cayenne, Etc/GMT+2, Atlantic/South_Georgia, Atlantic/Azores, Atlantic/Cape_Verde, Africa/Casablanca, Atlantic/Reykjavik, Europe/London, Etc/GMT+0, Europe/Amsterdam, Europe/Belgrade, Europe/Paris, Europe/Sarajevo, Africa/Algiers, Africa/Windhoek, Asia/Amman, Europe/Athens, Asia/Beirut, Africa/Cairo, Africa/Harare, Europe/Helsinki, Europe/Kaliningrad, Europe/Nicosia, Asia/Damascus, Asia/Istanbul, Asia/Jerusalem, Asia/Baghdad, Asia/Kuwait, Africa/Nairobi, Europe/Moscow, Asia/Tehran, Asia/Dubai, Asia/Baku, Asia/Yerevan, Indian/Mauritius, Asia/Tbilisi, Asia/Kabul, Asia/Yekaterinburg, Asia/Karachi, Asia/Tashkent, Asia/Calcutta, Asia/Colombo, Asia/Katmandu, Asia/Novosibirsk, Asia/Dhaka, Asia/Rangoon, Asia/Bangkok, Asia/Krasnoyarsk, Asia/Hong_Kong, Asia/Singapore, Asia/Taipei, Asia/Irkutsk, Asia/Ulaanbaatar, Australia/Perth, Asia/Tokyo, Asia/Seoul, Asia/Yakutsk, Australia/Adelaide, Australia/Darwin, Australia/Brisbane, Pacific/Port_Moresby, Australia/Melbourne, Australia/Hobart, Asia/Vladivostok, Australia/Lord_Howe, Pacific/Guadalcanal, Asia/Magadan, Pacific/Auckland, Pacific/Fiji, Pacific/Tongatapu |
clone_network_id | integer |
ID of the group that config shall be cloned from
|
clone_ssid | boolean |
True: to clone SSID profiles
|
clone_vlan | boolean |
True: to clone VLAN networks
|
clone_captive_portal | boolean |
True: to clone captive portal profiles
|
clone_device_schedule | boolean |
True: to clone device schedules
|
schedule_reboot_enabled | boolean |
True: Reboot schedule managed by IC2. False: Follow existing reboot schedule setting in device
|
apply_timezone | boolean |
Default True: Devices follow this time zone setting
|
clone_firewall_rule | boolean |
True: to clone firewall rules
|
clone_outbound_policy | boolean |
True: to clone outbound policies
|
Field | Type | Description |
---|---|---|
resp_code | string |
Response code
SUCCESS, INVALID_INPUT, INTERNAL_ERROR, PENDING |
caller_ref | string |
Caller reference identifier, auto generated if not specified
|
server_ref | string |
Server reference identifier, generated on server side
|
message | string |
Response message
|
data |
Response data object
|
Parameters
Response Content Type:
Model Schema
Model | Response Sample | Model Description
[expand] | [collapse]
[expand] | [collapse]
[expand] | [collapse]
Parameters
application/json
Model Schema
Model | Response Sample | Model Description
response { resp_code (string): Response code, caller_ref (string): Caller reference identifier, auto generated if not specified, server_ref (string): Server reference identifier, generated on server side, message (string): Response message, data (array[group]): Response data object, } group { id (integer): Group identifier, name (string): Name of the group, online_device_count (integer): Number of online devices in this group, offline_device_count (integer): Number of offline devices in this group, client_count (integer): Number of clients in this group, expiry_count (integer): Number of expired devices in this group, expiry_soon_count (integer): Number of expiring-soon devices in this group, group_type (string): Group type, timezone (string): Group timezone, country (string): Static location country, address (string): Static location address, longitude (number): Static location longitude, latitude (number): Static location latitude, note (string): Note, incontrol_redirect (string): External InControl Appliance Setting - "Use External InControl Appliance" setting, incontrol_host1 (string): External InControl Appliance Setting - Primary Appliance Address, incontrol_host2 (string): External InControl Appliance Setting - Secondary Appliance Address, incontrol_redirect_xtag (string): External InControl Appliance Setting - Device Selection, incontrol_redirect_device_tags (array[tag_info]): External InControl Appliance Setting - Selected device tags, failover_to_ic2 (boolean): External InControl Appliance Setting - Indicates if "Fail over to Peplink InControl in Public Cloud" is enabled, custom_common_name (string): External InControl Appliance Setting - Custom Common Name, custom_certificate (string): External InControl Appliance Setting - Custom Certificate, is_gps_tracking_disabled (boolean): Indicates if GPS Location Collection is disabled, is_apply_bulk_config (boolean): Indicates if the group has bulk configuration settings, is_suspend_config_update (boolean): Indicates if Device Configuration is disabled, is_suspend_device_reporting (boolean): Indicates if Device Reporting is disabled, is_suspend_live_status (boolean): Indicates if Live Status Queries is disabled, is_suspend_firmware_upgrade (boolean): Indicates if Firmware Management is disabled, favorite (boolean): Indicated if the group is marked as favorite in InControl (starred), contenthub_threshold_enabled (boolean): InControl Notifications setting - Indicates if ContentHub Storage Threshold is enabled, contenthub_threshold (integer): ContentHub Storage Threshold, wan_disconnected_notify_time (integer): InControl Device List Disconnected WAN Icon Setting - WAN disconnected notify time, in seconds, default 0 = no warning, is_low_data_usage_mode (boolean): Indicates if Low Data Usage Mode is enabled, gps_location_sampling (integer): GPS Location Collection, 0 - Disabled, 2 - 30 location points every minute (default), 60 - 60 location points every hour, 1800 - 1 location point every 30 minutes, 3600 - 1 location point every hour, min_heartbreak_interval (integer): Minimum Communication Interval in seconds, locked_devices (integer): Number of locked device in this group, Only appears when is_show_detail=true, outstanding_patch_devices (integer): Number of devices that its configuration is on hold in this group, Only appears when is_show_detail=true, } tag_info { id (integer): Unique identifier of the device tag, name (string): Device tag name, }
{ "resp_code": "", "caller_ref": "", "server_ref": "", "message": "", "data": [ { "id": 0, "name": "", "online_device_count": 0, "offline_device_count": 0, "client_count": 0, "expiry_count": 0, "expiry_soon_count": 0, "group_type": "", "timezone": "", "country": "", "address": "", "longitude": 0.0, "latitude": 0.0, "note": "", "incontrol_redirect": "", "incontrol_host1": "", "incontrol_host2": "", "incontrol_redirect_xtag": "", "incontrol_redirect_device_tags": [ { "id": 0, "name": "" } ], "failover_to_ic2": true, "custom_common_name": "", "custom_certificate": "", "is_gps_tracking_disabled": true, "is_apply_bulk_config": true, "is_suspend_config_update": true, "is_suspend_device_reporting": true, "is_suspend_live_status": true, "is_suspend_firmware_upgrade": true, "favorite": true, "contenthub_threshold_enabled": true, "contenthub_threshold": 0, "wan_disconnected_notify_time": 0, "is_low_data_usage_mode": true, "gps_location_sampling": 0, "min_heartbreak_interval": 0, "locked_devices": 0, "outstanding_patch_devices": 0 } ] }
Field | Type | Description |
---|---|---|
resp_code | string |
Response code
SUCCESS, INVALID_INPUT, INTERNAL_ERROR, PENDING |
caller_ref | string |
Caller reference identifier, auto generated if not specified
|
server_ref | string |
Server reference identifier, generated on server side
|
message | string |
Response message
|
data | array[group] |
Response data object
|
Field | Type | Description |
---|---|---|
id | integer |
Group identifier
|
name | string |
Name of the group
|
online_device_count | integer |
Number of online devices in this group
|
offline_device_count | integer |
Number of offline devices in this group
|
client_count | integer |
Number of clients in this group
|
expiry_count | integer |
Number of expired devices in this group
|
expiry_soon_count | integer |
Number of expiring-soon devices in this group
|
group_type | string |
Group type
peplink |
timezone | string |
Group timezone
|
country | string |
Static location country
|
address | string |
Static location address
|
longitude | number |
Static location longitude
|
latitude | number |
Static location latitude
|
note | string |
Note
|
incontrol_redirect | string |
External InControl Appliance Setting - "Use External InControl Appliance" setting
|
incontrol_host1 | string |
External InControl Appliance Setting - Primary Appliance Address
|
incontrol_host2 | string |
External InControl Appliance Setting - Secondary Appliance Address
|
incontrol_redirect_xtag | string |
External InControl Appliance Setting - Device Selection
none, include, includeall, exclude |
incontrol_redirect_device_tags | array[tag_info] |
External InControl Appliance Setting - Selected device tags
|
failover_to_ic2 | boolean |
External InControl Appliance Setting - Indicates if "Fail over to Peplink InControl in Public Cloud" is enabled
|
custom_common_name | string |
External InControl Appliance Setting - Custom Common Name
|
custom_certificate | string |
External InControl Appliance Setting - Custom Certificate
|
is_gps_tracking_disabled | boolean |
Indicates if GPS Location Collection is disabled
|
is_apply_bulk_config | boolean |
Indicates if the group has bulk configuration settings
|
is_suspend_config_update | boolean |
Indicates if Device Configuration is disabled
|
is_suspend_device_reporting | boolean |
Indicates if Device Reporting is disabled
|
is_suspend_live_status | boolean |
Indicates if Live Status Queries is disabled
|
is_suspend_firmware_upgrade | boolean |
Indicates if Firmware Management is disabled
|
favorite | boolean |
Indicated if the group is marked as favorite in InControl (starred)
|
contenthub_threshold_enabled | boolean |
InControl Notifications setting - Indicates if ContentHub Storage Threshold is enabled
|
contenthub_threshold | integer |
ContentHub Storage Threshold
|
wan_disconnected_notify_time | integer |
InControl Device List Disconnected WAN Icon Setting - WAN disconnected notify time, in seconds, default 0 = no warning
2.8.3 |
is_low_data_usage_mode | boolean |
Indicates if Low Data Usage Mode is enabled
|
gps_location_sampling | integer |
GPS Location Collection, 0 - Disabled, 2 - 30 location points every minute (default), 60 - 60 location points every hour, 1800 - 1 location point every 30 minutes, 3600 - 1 location point every hour
0, 2, 60, 1800, 3600 |
min_heartbreak_interval | integer |
Minimum Communication Interval in seconds
|
locked_devices | integer |
Number of locked device in this group, Only appears when is_show_detail=true
|
outstanding_patch_devices | integer |
Number of devices that its configuration is on hold in this group, Only appears when is_show_detail=true
|
Field | Type | Description |
---|---|---|
id | integer |
Unique identifier of the device tag
|
name | string |
Device tag name
|
Parameters
Response Content Type:
Model Schema
Model | Response Sample | Model Description
[expand] | [collapse]
[expand] | [collapse]
[expand] | [collapse]
Parameters
application/json
Model Schema
Model | Response Sample | Model Description
response { resp_code (string): Response code, caller_ref (string): Caller reference identifier, auto generated if not specified, server_ref (string): Server reference identifier, generated on server side, message (string): Response message, data (group): Response data object, } group { id (integer): Group identifier, name (string): Name of the group, online_device_count (integer): Number of online devices in this group, offline_device_count (integer): Number of offline devices in this group, client_count (integer): Number of clients in this group, expiry_count (integer): Number of expired devices in this group, expiry_soon_count (integer): Number of expiring-soon devices in this group, group_type (string): Group type, timezone (string): Group timezone, country (string): Static location country, address (string): Static location address, longitude (number): Static location longitude, latitude (number): Static location latitude, note (string): Note, incontrol_redirect (string): External InControl Appliance Setting - "Use External InControl Appliance" setting, incontrol_host1 (string): External InControl Appliance Setting - Primary Appliance Address, incontrol_host2 (string): External InControl Appliance Setting - Secondary Appliance Address, incontrol_redirect_xtag (string): External InControl Appliance Setting - Device Selection, incontrol_redirect_device_tags (array[tag_info]): External InControl Appliance Setting - Selected device tags, failover_to_ic2 (boolean): External InControl Appliance Setting - Indicates if "Fail over to Peplink InControl in Public Cloud" is enabled, custom_common_name (string): External InControl Appliance Setting - Custom Common Name, custom_certificate (string): External InControl Appliance Setting - Custom Certificate, is_gps_tracking_disabled (boolean): Indicates if GPS Location Collection is disabled, is_apply_bulk_config (boolean): Indicates if the group has bulk configuration settings, is_suspend_config_update (boolean): Indicates if Device Configuration is disabled, is_suspend_device_reporting (boolean): Indicates if Device Reporting is disabled, is_suspend_live_status (boolean): Indicates if Live Status Queries is disabled, is_suspend_firmware_upgrade (boolean): Indicates if Firmware Management is disabled, favorite (boolean): Indicated if the group is marked as favorite in InControl (starred), contenthub_threshold_enabled (boolean): InControl Notifications setting - Indicates if ContentHub Storage Threshold is enabled, contenthub_threshold (integer): ContentHub Storage Threshold, wan_disconnected_notify_time (integer): InControl Device List Disconnected WAN Icon Setting - WAN disconnected notify time, in seconds, default 0 = no warning, is_low_data_usage_mode (boolean): Indicates if Low Data Usage Mode is enabled, gps_location_sampling (integer): GPS Location Collection, 0 - Disabled, 2 - 30 location points every minute (default), 60 - 60 location points every hour, 1800 - 1 location point every 30 minutes, 3600 - 1 location point every hour, min_heartbreak_interval (integer): Minimum Communication Interval in seconds, locked_devices (integer): Number of locked device in this group, Only appears when is_show_detail=true, outstanding_patch_devices (integer): Number of devices that its configuration is on hold in this group, Only appears when is_show_detail=true, } tag_info { id (integer): Unique identifier of the device tag, name (string): Device tag name, }
{ "resp_code": "", "caller_ref": "", "server_ref": "", "message": "", "data": { "id": 0, "name": "", "online_device_count": 0, "offline_device_count": 0, "client_count": 0, "expiry_count": 0, "expiry_soon_count": 0, "group_type": "", "timezone": "", "country": "", "address": "", "longitude": 0.0, "latitude": 0.0, "note": "", "incontrol_redirect": "", "incontrol_host1": "", "incontrol_host2": "", "incontrol_redirect_xtag": "", "incontrol_redirect_device_tags": [ { "id": 0, "name": "" } ], "failover_to_ic2": true, "custom_common_name": "", "custom_certificate": "", "is_gps_tracking_disabled": true, "is_apply_bulk_config": true, "is_suspend_config_update": true, "is_suspend_device_reporting": true, "is_suspend_live_status": true, "is_suspend_firmware_upgrade": true, "favorite": true, "contenthub_threshold_enabled": true, "contenthub_threshold": 0, "wan_disconnected_notify_time": 0, "is_low_data_usage_mode": true, "gps_location_sampling": 0, "min_heartbreak_interval": 0, "locked_devices": 0, "outstanding_patch_devices": 0 } }
Field | Type | Description |
---|---|---|
resp_code | string |
Response code
SUCCESS, INVALID_INPUT, INTERNAL_ERROR, PENDING |
caller_ref | string |
Caller reference identifier, auto generated if not specified
|
server_ref | string |
Server reference identifier, generated on server side
|
message | string |
Response message
|
data | group |
Response data object
|
Field | Type | Description |
---|---|---|
id | integer |
Group identifier
|
name | string |
Name of the group
|
online_device_count | integer |
Number of online devices in this group
|
offline_device_count | integer |
Number of offline devices in this group
|
client_count | integer |
Number of clients in this group
|
expiry_count | integer |
Number of expired devices in this group
|
expiry_soon_count | integer |
Number of expiring-soon devices in this group
|
group_type | string |
Group type
peplink |
timezone | string |
Group timezone
|
country | string |
Static location country
|
address | string |
Static location address
|
longitude | number |
Static location longitude
|
latitude | number |
Static location latitude
|
note | string |
Note
|
incontrol_redirect | string |
External InControl Appliance Setting - "Use External InControl Appliance" setting
|
incontrol_host1 | string |
External InControl Appliance Setting - Primary Appliance Address
|
incontrol_host2 | string |
External InControl Appliance Setting - Secondary Appliance Address
|
incontrol_redirect_xtag | string |
External InControl Appliance Setting - Device Selection
none, include, includeall, exclude |
incontrol_redirect_device_tags | array[tag_info] |
External InControl Appliance Setting - Selected device tags
|
failover_to_ic2 | boolean |
External InControl Appliance Setting - Indicates if "Fail over to Peplink InControl in Public Cloud" is enabled
|
custom_common_name | string |
External InControl Appliance Setting - Custom Common Name
|
custom_certificate | string |
External InControl Appliance Setting - Custom Certificate
|
is_gps_tracking_disabled | boolean |
Indicates if GPS Location Collection is disabled
|
is_apply_bulk_config | boolean |
Indicates if the group has bulk configuration settings
|
is_suspend_config_update | boolean |
Indicates if Device Configuration is disabled
|
is_suspend_device_reporting | boolean |
Indicates if Device Reporting is disabled
|
is_suspend_live_status | boolean |
Indicates if Live Status Queries is disabled
|
is_suspend_firmware_upgrade | boolean |
Indicates if Firmware Management is disabled
|
favorite | boolean |
Indicated if the group is marked as favorite in InControl (starred)
|
contenthub_threshold_enabled | boolean |
InControl Notifications setting - Indicates if ContentHub Storage Threshold is enabled
|
contenthub_threshold | integer |
ContentHub Storage Threshold
|
wan_disconnected_notify_time | integer |
InControl Device List Disconnected WAN Icon Setting - WAN disconnected notify time, in seconds, default 0 = no warning
2.8.3 |
is_low_data_usage_mode | boolean |
Indicates if Low Data Usage Mode is enabled
|
gps_location_sampling | integer |
GPS Location Collection, 0 - Disabled, 2 - 30 location points every minute (default), 60 - 60 location points every hour, 1800 - 1 location point every 30 minutes, 3600 - 1 location point every hour
0, 2, 60, 1800, 3600 |
min_heartbreak_interval | integer |
Minimum Communication Interval in seconds
|
locked_devices | integer |
Number of locked device in this group, Only appears when is_show_detail=true
|
outstanding_patch_devices | integer |
Number of devices that its configuration is on hold in this group, Only appears when is_show_detail=true
|
Field | Type | Description |
---|---|---|
id | integer |
Unique identifier of the device tag
|
name | string |
Device tag name
|
Parameters
Since:
Response Content Type:
Model Schema
Model | Response Sample | Model Description
[expand] | [collapse]
[expand] | [collapse]
[expand] | [collapse]
Parameters
2.8.2
Response Content Type:
application/json
Model Schema
Model | Response Sample | Model Description
response { resp_code (string): Response code, caller_ref (string): Caller reference identifier, auto generated if not specified, server_ref (string): Server reference identifier, generated on server side, message (string): Response message, data (access_control_list): Response data object, } access_control_list { id (integer): Unique identifier of the access control list, group_id (integer): Unique identifier of the group, name (string): Name of the access control list, address (array[string]): List of MAC addresses, referenced_by (array[access_control_list_referenced_by]): List of access control list reference by object, Only appears when with_reference=true, } access_control_list_referenced_by { type (string): Type of reference object, id (integer): Unique identifier of the reference object, name (string): Name of the reference object, device_id (integer): Unique identifier of the device, group_id (integer): Unique identifier of the group, }
{ "resp_code": "", "caller_ref": "", "server_ref": "", "message": "", "data": { "id": 0, "group_id": 0, "name": "", "address": [ "" ], "referenced_by": [ { "type": "", "id": 0, "name": "", "device_id": 0, "group_id": 0 } ] } }
Field | Type | Description |
---|---|---|
resp_code | string |
Response code
SUCCESS, INVALID_INPUT, INTERNAL_ERROR, PENDING |
caller_ref | string |
Caller reference identifier, auto generated if not specified
|
server_ref | string |
Server reference identifier, generated on server side
|
message | string |
Response message
|
data | access_control_list |
Response data object
|
Field | Type | Description |
---|---|---|
id | integer |
Unique identifier of the access control list
|
group_id | integer |
Unique identifier of the group
|
name | string |
Name of the access control list
|
address | array[string] |
List of MAC addresses
|
referenced_by | array[access_control_list_referenced_by] |
List of access control list reference by object, Only appears when with_reference=true
|
Field | Type | Description |
---|---|---|
type | string |
Type of reference object
firewall, outbound, ssid, portal, custom_portal |
id | integer |
Unique identifier of the reference object
|
name | string |
Name of the reference object
|
device_id | integer |
Unique identifier of the device
|
group_id | integer |
Unique identifier of the group
|
Parameters
Since:
Request Content Type:
Response Content Type:
Parameters
2.8.2
Request Content Type:
application/json
Response Content Type:
application/json
Parameters
Since:
Response Content Type:
Parameters
2.8.2
Response Content Type:
application/json
Parameters
Since:
Request Content Type:
Response Content Type:
Parameters
2.8.2
Request Content Type:
application/json
Response Content Type:
application/json
Parameters
Since:
Response Content Type:
Parameters
2.8.2
Response Content Type:
application/json
Parameters
Request Content Type:
Response Content Type:
Model Schema
Model | Request Sample | Response Sample | Model Description
[expand] | [collapse]
[expand] | [collapse]
[expand] | [collapse]
[expand] | [collapse]
Parameters
application/json
Response Content Type:
application/json
Model Schema
Model | Request Sample | Response Sample | Model Description
request { data (array[add_device_request]): Request data object, } add_device_request { sn (string): Device S/N, name (string): Device name, if not specified, the device name would be same as sn., latitude (number): Location latitude, if not specified, the device location would be same as group location., longitude (number): Location longitude, if not specified, the device location would be same as group location., address (string): Location address, if not specified, the device location would be same as group location., } response { resp_code (string): Response code, caller_ref (string): Caller reference identifier, auto generated if not specified, server_ref (string): Server reference identifier, generated on server side, message (string): Response message, data (array[add_device_response]): Response data object, } add_device_response { sn (string): Device S/N, id (integer): Device identifier, name (string): Device name, latitude (number): Location latitude, longitude (number): Location longitude, address (string): Location address, status (string): Indicate if the add device process is success or not, message (string): Result message,
invalid_device: Invalid serial number
already_registered: Device already registered in InControl
not_found: Device not found
ready_register_expired:When add device success, this warning message exists if the device already expired., }
{ "data": [ { "sn": "", "name": "", "latitude": 0.0, "longitude": 0.0, "address": "" } ] }
{ "resp_code": "", "caller_ref": "", "server_ref": "", "message": "", "data": [ { "sn": "", "id": 0, "name": "", "latitude": 0.0, "longitude": 0.0, "address": "", "status": "", "message": "" } ] }
Field | Type | Description |
---|---|---|
data | array[add_device_request] |
Request data object
|
Field | Type | Description |
---|---|---|
sn | string |
Device S/N
|
name | string |
Device name, if not specified, the device name would be same as sn.
|
latitude | number |
Location latitude, if not specified, the device location would be same as group location.
|
longitude | number |
Location longitude, if not specified, the device location would be same as group location.
|
address | string |
Location address, if not specified, the device location would be same as group location.
|
Field | Type | Description |
---|---|---|
resp_code | string |
Response code
SUCCESS, INVALID_INPUT, INTERNAL_ERROR, PENDING |
caller_ref | string |
Caller reference identifier, auto generated if not specified
|
server_ref | string |
Server reference identifier, generated on server side
|
message | string |
Response message
|
data | array[add_device_response] |
Response data object
|
Field | Type | Description |
---|---|---|
sn | string |
Device S/N
|
id | integer |
Device identifier
|
name | string |
Device name
|
latitude | number |
Location latitude
|
longitude | number |
Location longitude
|
address | string |
Location address
|
status | string |
Indicate if the add device process is success or not
success, fail |
message | string |
Result message,
invalid_device: Invalid serial number already_registered: Device already registered in InControl not_found: Device not found ready_register_expired:When add device success, this warning message exists if the device already expired. invalid_device, already_registered, not_found, ready_register_expired |
Parameters
Since:
Response Content Type:
Parameters
2.3.5
Response Content Type:
application/json
Parameters
Since:
Response Content Type:
Model Schema
Model | Response Sample | Model Description
[expand] | [collapse]
[expand] | [collapse]
[expand] | [collapse]
Parameters
2.3.5
Response Content Type:
text/csv
Model Schema
Model | Response Sample | Model Description
bandwidth_usage { from_date (string): Usage start date, to_date (string): Usage end date, up (number): Upload value (MB for hourly, daily, monthly, kbps for per-minute), down (number): Download value (MB for hourly, daily, monthly, kbps for per-minute), }
from_date,to_date,up,down
Field | Type | Description |
---|---|---|
from_date | string |
Usage start date
|
to_date | string |
Usage end date
|
up | number |
Upload value (MB for hourly, daily, monthly, kbps for per-minute)
|
down | number |
Download value (MB for hourly, daily, monthly, kbps for per-minute)
|
Parameters
Since:
Response Content Type:
Model Schema
Model | Response Sample | Model Description
[expand] | [collapse]
[expand] | [collapse]
[expand] | [collapse]
Parameters
2.6.2
Response Content Type:
application/json
Model Schema
Model | Response Sample | Model Description
response { resp_code (string): Response code, caller_ref (string): Caller reference identifier, auto generated if not specified, server_ref (string): Server reference identifier, generated on server side, message (string): Response message, data (array[captive_portal_user_info]): Response data object, } captive_portal_user_info { access_mode (string): Captive portal access mode, social_network_user_id (string): User id collected in social mode, email (string): Email collected in e-mail or social mode, visit_count (number): No. of visit, first_login (string): First login date, in YYYY-MM-DD'T'HH:MM:SS format, last_login (string): Last login date, in YYYY-MM-DD'T'HH:MM:SS format, mobile_number (string): Mobile number collected in e-mail or SMS mode, first_name (string): First name collected in e-mail mode, last_name (string): Last name collected in e-mail mode, gender (string): Gender collected in e-mail mode, country (string): Country collected in e-mail mode, }
{ "resp_code": "", "caller_ref": "", "server_ref": "", "message": "", "data": [ { "access_mode": "", "social_network_user_id": "", "email": "", "visit_count": 0.0, "first_login": "", "last_login": "", "mobile_number": "", "first_name": "", "last_name": "", "gender": "", "country": "" } ] }
Field | Type | Description |
---|---|---|
resp_code | string |
Response code
SUCCESS, INVALID_INPUT, INTERNAL_ERROR, PENDING |
caller_ref | string |
Caller reference identifier, auto generated if not specified
|
server_ref | string |
Server reference identifier, generated on server side
|
message | string |
Response message
|
data | array[captive_portal_user_info] |
Response data object
|
Field | Type | Description |
---|---|---|
access_mode | string |
Captive portal access mode
|
social_network_user_id | string |
User id collected in social mode
|
string |
Email collected in e-mail or social mode
|
|
visit_count | number |
No. of visit
|
first_login | string |
First login date, in YYYY-MM-DD'T'HH:MM:SS format
|
last_login | string |
Last login date, in YYYY-MM-DD'T'HH:MM:SS format
|
mobile_number | string |
Mobile number collected in e-mail or SMS mode
|
first_name | string |
First name collected in e-mail mode
|
last_name | string |
Last name collected in e-mail mode
|
gender | string |
Gender collected in e-mail mode
|
country | string |
Country collected in e-mail mode
|
Parameters
GET
/rest/o/{organization_id}/g/{group_id}/captive_portal_user_info/csv
Get captive portal user info in CSV format
Since:
Response Content Type:
Model Schema
Model | Response Sample | Model Description
[expand] | [collapse]
[expand] | [collapse]
[expand] | [collapse]
Parameters
2.6.2
Response Content Type:
text/csv
Model Schema
Model | Response Sample | Model Description
captive_portal_user_info_csv { "Access Mode" (string): Captive portal access mode, "Social Network ID" (string): User id collected in social mode, "E-mail Address" (string): Email collected in e-mail or social mode (Facebook, Google ID, LinkedIn), "Visit Count" (number): No. of visit, "First Login" (string): First login date, in YYYY-MM-DD'T'HH:MM:SS format, "Last Login" (string): Last login date, in YYYY-MM-DD'T'HH:MM:SS format, "Mobile Number" (string): Mobile number collected in e-mail or SMS mode, "Name" (string): First name and Last name collected in e-mail mode, "Gender" (string): Gender collected in e-mail mode, "Country" (string): Country collected in e-mail mode, }
"Access Mode","Social Network ID","E-mail Address","Visit Count","First Login","Last Login","Mobile Number","Name","Gender","Country"
Field | Type | Description |
---|---|---|
"Access Mode" | string |
Captive portal access mode
|
"Social Network ID" | string |
User id collected in social mode
|
"E-mail Address" | string |
Email collected in e-mail or social mode (Facebook, Google ID, LinkedIn)
|
"Visit Count" | number |
No. of visit
|
"First Login" | string |
First login date, in YYYY-MM-DD'T'HH:MM:SS format
|
"Last Login" | string |
Last login date, in YYYY-MM-DD'T'HH:MM:SS format
|
"Mobile Number" | string |
Mobile number collected in e-mail or SMS mode
|
"Name" | string |
First name and Last name collected in e-mail mode
|
"Gender" | string |
Gender collected in e-mail mode
|
"Country" | string |
Country collected in e-mail mode
|
Parameters
Response Content Type:
Model Schema
Model | Response Sample | Model Description
[expand] | [collapse]
[expand] | [collapse]
[expand] | [collapse]
Parameters
application/json
Model Schema
Model | Response Sample | Model Description
response { resp_code (string): Response code, caller_ref (string): Caller reference identifier, auto generated if not specified, server_ref (string): Server reference identifier, generated on server side, message (string): Response message, data (array[client]): Response data object, } client { client_id (string): Unique identifier of the client, mac (string): MAC address, device (device): The device the client currently attached to, duration (integer): Wi-Fi connection duration in seconds, connection_type (string): Connected via Wi-Fi or Ethernet, status (string): Online status, ssid (string): SSID the client connected to, channel (integer): Wi-Fi channel of the client connection, ip (string): IP address, channel_width (number): Wi-Fi channel width, radio_mode (string): Wi-Fi radio mode, signal (number): Signal strength, longitude (number): Location longitude, latitude (number): Location latitude, radius (number): The distance from the longitude and latitude the client could locate, last_seen (string): Last seen date and time of the client, } device { id (integer): Unique identifier of the device, group_id (integer): Unique identifier of the group, group_name (string): Name of the group, sn (string): Device S/N, name (string): Device name, status (string): Device status, usage (number): Current bandwidth usage, tx (number): Current upload usage, rx (number): Current download usage, product_id (integer): Unique identifier of the product, client_count (integer): Current client count, fw_ver (string): Firmware version using, last_online (string): Last online date and time, offline_at (string): Last offline date and time, first_appear (string): First appeared date and time, lan_mac (string): LAN MAC address, config_rollback (boolean): Indicates if the recent change in outbound policy or firewall rules applied from InControl has been rolled back as the device was unable to reach InControl., config_rollback_date (string): Config roll back date and time, ic2_config_apply_locked (boolean): Indicates if the device is "Config Locked" by InControl, outstanding_patch_ids (array[string]): Unique identifier of the outstanding configuration patches, device_config_apply_locked (boolean): Indicates if the device is "Config Locked" by device, sp_default (boolean): Indicates if the active configuration is saved as SP default, product_name (string): Product name, product_code (string): Product code, mv (string): Model variant, tags (array[string]): List of Device tags name, tag_info (array[tag_info]): List of Device tags information, note (string): Note, longitude (number): Location longitude, latitude (number): Location latitude, address (string): Location address, location_timestamp (string): Location recorded time, follow_loc_dev (integer): Device's ID of the followed location device, follow_loc_dev_info (follow_loc_dev_info): Followed location device information, isStatic (boolean): Indicates if the returned location is a static one, expiry_date (string): Warranty expiry date, sub_expiry_date (string): Subscription expiry date, prime_expiry_date (string): Prime expiry date, prime_type (integer): Prime Type: 1 - with prime subscription, 0 or undefined - without prime subscription, expired (boolean): Indicates if the device warranty has expired, sub_expired (boolean): Indicates if the device subscription has expired, gps_support (boolean): Indicates if the device support gps, gps_exist (boolean): Indicates if the device with any gps records, support_ssid_count (number): Supported number of SSIDs, radio_modules (array[radio_module]): Supported radio modules, group_type (string): Group type, device_type (string): Device type, last_sync_date (string): Last config applied date and time, v6_license (string): Indicates if the device has activated firmware 6.x license, uptime (integer): Device up time, uptime_appear (string): Retrieval time of the device up time, fw_pending_trial_round (integer): Firmware update trial count, fw_pending_max_no_of_trial (integer): Maximum number of firmware update trial count, fw_pending_ver (string): Version of the firmware to be updated, fw_pending_schedule_time (string): Scheduled firmware update start time, fw_pending_upgrade_time (string): Actual firmware update time, fw_pending_status (integer): Firmware update status, 1 - active, 0 - inactive, fw_pending_group_time (string): Pending firmware update time in the group's time zone, is_master_device (boolean): Indicates if the device is a master configuration cloning device, fw_managmed (string): (only for device detail call) Indicates if the firmware is managed by organization level, group level or device level, wifi_cfg (string): Indicates the device follows group or device level's SSID settings, or locally managed on the device, ddns_enabled (boolean): Indicates if "Find My Peplink Service" enabled, ddns_available (boolean): Indicates if "Find My Peplink Service" available, ddns_letsencrypt_enabled (boolean): Indicates if "Manage Web Admin SSL Certificate" is enabled for "Find My Peplink Service", ddns_letsencrypt_cert_expiry_date (string): Web Admin SSL certificate expiry date and time, ddns_letsencrypt_apply_date (string): Web Admin SSL certificate apply date and time, onlineStatus (string): Current online status, wtp_ip (string): Last Detected IP, interfaces (array[interface]): Device interfaces, vlan_interfaces (array[vlan_interface]): VLAN interfaces, ssid_profiles (array[ssid_profile]): SSID profiles, ssid_profiles_applied (array[ssid_profiles_applied]): Applied SSID profiles, hardware_version (string): Hardware version, mvpn_version (string): MVPN version, radio_bands (array[radio_band]): Radio bands, loc_display (boolean): Indicates if address displayed on "Location" field in InControl Device Detail Page: true - display address, false - display latitude/longitude, extap_proxy_supported (boolean): Indicates if the device is a AP controller, extap_proxy_enabled (boolean): Indicates if the device is a managed by AP controller, wlan_probe_supported (boolean): Indicates if the device supports "Collecting Wi-Fi Analytics Data", wlan_probe_enabled (boolean): Indicates if the device enabled "Collecting Wi-Fi Analytics Data" in InControl, dpi_supported (boolean): Indicates if the device supports deep packet inspection, dpi_enabled (boolean): Indicates if the device enabled deep packet inspection, low_data_usage_mode (boolean): Indicates if the device enabled low data usage mode, ra_enabled (boolean): Indicates if the device enabled remote assistance, watchdog_enabled (boolean): Indicates if the device enabled hardware watchdog, ra_supported (boolean): Indicates if the device support remote assistance, watchdog_supported (boolean): Indicates if the device support hardware watchdog, ap_router_mode (boolean): Indicates if the device applied router mode, true - router mode, false - bridge mode, ssid_mac_list (array[ssid_mac_list]): SSID mac list, site_id (string): PepVPN Site ID, handshake_port (boolean): (PepVPN / SpeedFusion) Handshake port, refuse_legacy (boolean): (PepVPN / SpeedFusion) Indicates if the device accept connections from legacy firmware, peer_connections (integer): PepVPN / SpeedFusion Peer Connections, pepvpn_peers (integer): Maximum number of PepVPN / SpeedFusion Peer Connections, is_default_password (boolean): Indicates if default password is used in device web admin, is_apply_bulk_config (boolean): Indicates if the device is applied with bulk config, is_wlan_ap_suspended (boolean): Indicates if the device WLAN AP is suspended, is_ap_schedule_enabled (boolean): Indicates if the device AP schedule enabled, is_ha_enabled (boolean): Indicates if high availability enabled, is_ha_slave (boolean): Indicates if the device is a high availability slave unit, ha_role (string): High Availability Preferred Role (master|slave), ha_status (string): High Availability Status, ha_transition_time (string): Last Transition Date and time, periph_status_available (boolean): Indicates if periph status is available, periph_status (periph_status): Periph status, port_status_available (boolean): Indicates if port status is available, port_status (port_status): Port status, gobi_sim_lock_supported (boolean): Indicates if the device support SIM lock, gobi_sim_locks (array[string]): , poe_supported (boolean): Indicates if the device support poe, admin_conf (admin_conf): Admin configuration, outbound_policy_managed (boolean): , firewall_rules_managed (boolean): , is_apply_import_lan (boolean): , is_apply_csv_override (boolean): , is_wlc_enabled (boolean): , mgnt_incontrol_vlan_ip (string): , mgnt_incontrol_vlan (integer): , mgnt_incontrol_vlan_gateway (string): , mgnt_incontrol_vlan_dns (array[string]): , mgnt_incontrol_vlan_connection_type (string): , mgnt_vlan_ip (string): , mgnt_vlans (array[vlan_interface]): , max_lacp_group_support (integer): , max_port_per_lacp_group (integer): , endpoint_support (boolean): , slow_response (boolean): , slow_response_start_time (string): , wlan_mac_list (array[wlan_mac_list]): , slot_module_list (array[slot_module]): List of slot module information, vlan_managed (boolean): (device detail) Indicates if the device has VLAN managed, icmg_mvpn (boolean): , icmg_wan (boolean): Indicates if Device WAN settings is managed by InControl, icmg_schedule_reboot (boolean): Indicates if the device is applying Device Schedule Reboot, icmg_schedule (boolean): Indicates if the device is applying Device Schedule, icmg_wlan (boolean): Indicates if SSID and Radio settings is managed by InControl, icmg_portal (boolean): Indicates if Captive Portal is managed by InControl, icmg_lan (boolean): Indicates if Device LAN IP settings is managed by InControl, icmg_sdswitch (boolean): , icmg_outbound (boolean): Indicates if Outbound Policy managed by InControl, icmg_firewall (boolean): Indicates if Firewall Rules is managed by InControl, icmg_admin (boolean): Indicates if device web admin management is managed by InControl, } tag_info { id (integer): Unique identifier of the device tag, name (string): Device tag name, } follow_loc_dev_info { id (integer): Unique identifier of the followed device, sn (string): S/N of the followed device, name (string): Device name of the followed device, onlineStatus (string): Online status of the followed device, } radio_module { module_id (integer): System generated Wi-Fi radio module identifier, frequency_band (string): Supported radio frequency bands, active_frequency_band (string): The active frequency band, } interface { id (integer): System generated interface identifier, type (string): Interface type, status (string): Interface status for InControl, Connected|Disconnected|Disabled|No SIM Card Detected|No Cable Detected, last_status (string): Wan status, Only exists if the device is offline, name (string): Interface name, ddns_host (string): DDNS host, ddns_name (string): Find My Peplink Address, ddns_enabled (boolean): Indicates if DDNS is enabled, dns_servers (array[string]): List of dns servers, ip_status (string): , conn_len (integer): , ip (string): IP, netmask (string): Netmask, is_enable (boolean): Indicates if the interface is enabled, conn_mode (integer): Routing mode, port_type (integer): Port type, gateway (string): Default gateway, mtu (number): MTU, healthcheck (string): Health check method, "nslookup" - DNS Lookup, "pstr" - SmartCheck, "disabled" - Disabled, "ping" - PING, "http" - HTTP, sims (interface_sims): SIMs info, meid_hex (string): MEID DEC, esn (string): ESN, imei (string): IMEI, imei_cdf (string): Cellular Module, apn (string): APN, username (string): Username for APN, password (string): Password for APN, dialnum (string): Dial Number for APN, carrier_name (string): Carrier, carrier_settings (string): Carrier settings, s2g3glte (string): Indicates if the network is "3G", "4G" or "LTE", signal_bar (integer): Indicates the signal bar level, -1: no signal, 0-5: signal bar level, gobi_data_tech (string): Network, gobi_band_class_name (string): Network band, gobi_band_2_class_name (string): Secondary band, cellular_signals (interface_cellular_signals): Cellular signals, gobi_band_2_cellular_signals (interface_cellular_signals): Cellular signals, cell_id (integer): Cell ID, adaptor_type (string): Modem adaptor type, vendor_id (integer): Modem adaptor vendor ID, product_id (integer): Modem adaptor product ID, modem_name (string): Modem adaptor name, modem_manufacturer (string): Modem adaptor manufacturer, status_led (string): Indicates the interface status in color in InControl, is_overall_up (integer): , standby_state (string): Standby state, connected|disconnect, mtu_state (integer): , healthy_state (integer): , connection_state (integer): Connection state, physical_state (integer): Physical state, is_backup (integer): , is_quota_exceed (integer): , is_manual_disconnect (integer): , conn_config_method (string): Connection Method, standby_mode (string): Standby mode, mtu_config (integer): MTU config, group (integer): Indicates the priority group id, updated_at (string): Interface info updated date and time, } interface_sims { imsi (string): IMSI, iccid (string): ICCID, status (string): SIM Status, active (boolean): Indicates if the SIM is active, bandwidthAllowanceMonitor (interface_sims_bandwdith_allowance_monitor): Bandwidth allowance monitor information of the WAN connection or SIM, } interface_sims_bandwdith_allowance_monitor { enable (boolean): Indicates if the bandwidth allowance monitor is enabled, } interface_cellular_signals { rssi (number): Signal Strength in RSSI (dBm), sinr (number): Signal Quality in SINR (dB), rsrp (number): Signal Strength in RSRP (dBm), rsrq (number): Signal Quality in RSRQ (dB), } vlan_interface { vlan_id (integer): VLAN ID, vlan_ip (string): VLAN IP, netmask (string): VLAN netmask, name (string): VLAN name, icmg (boolean): Indicates if the VLAN is managed by InControl, portal_id (integer): Unique identifier of VLAN portal, portal_name (string): Name of the VLAN portal, portal_enabled (boolean): Indicates if the VLAN portal is enabled, } ssid_profile { tags (array[tag_info]): Device tag selected, exempt_tags (array[tag_info]): Device tag exempted, fast_transition (boolean): Indicates if Fast Transition is enabled, acl_id (integer): Unique identifier of the Access Control List applied, access_control_list (access_control_list): Access Control List, device_select (string): Device Selection, portal_id (integer): Unique identifier of the applied captive portal, access_mode (array[string]): Access mode of the applied captive portal, id (integer): Unique identifier of the SSID profile, enabled (boolean): Indicates if the SSID profile is enabled, ssid (string): SSID, security (string): SSID security type, wep (wep_settings): WEP Security settings, layer2_isolation (boolean): Indicates if Layer 2 Isolation is enabled, mac_filter (string): MAC address filtering type, mac_list (array[string]): MAC Address List, multicast_filter (boolean): Indicates if multicast Filter is enabled, multicast_rate (string): Multicast Rate, broadcast (boolean): Indicates whether SSID is broadcasted, otherwise hidden, icMg (boolean): Indicates if the SSID profile is managed in InControl, vlan_id (integer): VLAN ID, radio_band (string): Radio Band(s) the SSID is available on, radio_select (string): Radio Band selected, 1 - 2.4ghz, 2 - 5ghz, 3 - both, band_steering (string): Band Steering, Default value: 'preferred', igmp_snooping (boolean): Indicates if IGMP snooping is enabled, portal_enabled (boolean): Indicates if captive portal is applied for the SSID profile, portal_url (string): , portal_cacheId (string): , portal_auth (string): , portal_cna_bypass (boolean): , portal_domain_accept (string): , portal_idle_sec (integer): , portal_inactive_timeout (integer): , portal_logout_kick (boolean): , radius_nasid_type (string): NAS-Identifier in RADUIS server settings, radius_nasid_custom (string): NAS-Identifier custom value in RADUIS server settings, bandwidth_control (boolean): , client_bandwidth_upstream (integer): Per client upstream limit in kbps (0: Unlimited) (Pepwave AP only), client_bandwidth_downstream (integer): Per client downstream limit in kbps (0: Unlimited) (Pepwave AP only), bandwidth_upstream (integer): Upstream limit in kbps (0: Unlimited) (Pepwave AP only), bandwidth_downstream (integer): Downstream limit in kbps (0: Unlimited) (Pepwave AP only), block_lan_access (boolean): Indicates if Block LAN Access is enabled (Pepwave AP only), block_custom_subnet (boolean): Indicates if Custom Subnet is applied, block_custom_subnet_list (string): Custom Subnet (Pepwave AP only), block_except (boolean): Indicates if Block Exception is applied, block_except_list (string): Block Exception (Pepwave AP only), block_mvpn (boolean): Indicates Block PepVPN is enabled, client_limit (integer): Maximum number of clients for 2.4 GHz, client_limit_5g (integer): Maximum number of clients for 5 GHz, qos (integer): Network Priority (QoS), 0 - Gold, 1 - Silver, 2 - Bronze, wpa_personal (wpa_personal_settings): WPA/WPA2 Security settings, schedule_id (integer): Device schedule, portal_custom (boolean): Indicates if external captive portal is applied for the SSID profile, radius_servers (array[radius_server]): List of RADIUS Server settings, } access_control_list { id (integer): Unique identifier of the access control list, group_id (integer): Unique identifier of the group, name (string): Name of the access control list, address (array[string]): List of MAC addresses, referenced_by (array[access_control_list_referenced_by]): List of access control list reference by object, Only appears when with_reference=true, } access_control_list_referenced_by { type (string): Type of reference object, id (integer): Unique identifier of the reference object, name (string): Name of the reference object, device_id (integer): Unique identifier of the device, group_id (integer): Unique identifier of the group, } wep_settings { key_format (string): Key Format, key_size (integer): Key size, encrypt_key (string): Encryption key., shared_key_auth (boolean): Indicates whether shared key authentication is enabled, } wpa_personal_settings { psk_enable (boolean): Indicates whether pre-shared key is enabled, shared_key (string): The pre-shared key, shared_key_type (string): Shared Key Option
"static" - Static shared key
"lan_mac" - Last 8 octets of LAN MAC address
"random" - Random, shared_key_random_prefix (string): required when shared_key_type=random, Prefix in generated shared key, shared_key_random_alphas (integer): required when shared_key_type=random, Number of alphabets generated in shared key, shared_key_random_digits (integer): required when shared_key_type=random, Number of digits generated in shared key, regenerate_shared_key (boolean): when update a SSID profile, Indicates if regenerate key is enabled, regenerate_shared_key_device_tags (array[integer]): when update a SSID profile, List of device tags IDs applied for the regenerate key, } radius_server { id (integer): RADIUS server identifier, host (string): Server host name, secret (string): Server secret, auth_port (integer): RADIUS server authentication port, account_port (integer): RADIUS server accounting port, radius_nasid_type (string): NAS-Identifier, Default: device_name, radius_nasid_custom (string): NAS-Identifier custom value, required when radius_nasid_type=custom, } ssid_profiles_applied { id (integer): System generated SSID profile identifier, ssid (string): SSID, group_id (integer): Unique identifier of the group, device_id (integer): Unique identifier of the device, portal_id (integer): Unique identifier of the captive portal/external captive portal, enabled (boolean): Indicates if the ssid profile is enabled, icMg (boolean): Indicates if the ssid profile is managed by InControl, vlan_id (integer): VLAN ID, portal_custom (boolean): Indicates if the portal is external captive portal, wpa_passphrase (string): WPA passphrase, the field would be hidden for read-only users, } radio_band { radio_bands (integer): Unique identifier of the radio band, active_band (string): The active frequency band, txpower (number): Output power, channel (integer): Channel, channel_mode (string): Channel Mode, } ssid_mac_list { bssid (string): BSSID of the ESSID, essid (string): ESSID, radio (string): Radio band, security (string): the security policy of the SSID, } periph_status { cpu_load (usage_data): CPU load, power_state (power_state): Power State, power_usage (usage_data): Power Usage, fan_speed (usage_data): Fan speed, thermal_sensor (temperature): Thermal Sensor, } usage_data { name (string): Name, value (number): Value, total (number): Total, voltage (number): Voltage, current (number): Current, percentage (number): Percentage, active (boolean): Active, } power_state { name (string): Name, connect (boolean): Indicates if the power is connected, } temperature { temperature (number): Temperature, max (number): Maximum, threshold (number): Threshold, min (number): Minimum, } port_status { } admin_conf { managed (boolean): Indicates if device web admin management is enabled, protocol (string): , admin_auth (string): , admin_user_auth (string): , version (integer): , admin_name (string): Admin User Name, admin_password (string): Admin password, admin_readonly_name (string): Read-only User Name, admin_readonly_password (string): Read-only User password, admin_radius_enable (boolean): Indicates if Authentication by RADIUS is enabled, } wlan_mac_list { bssid (string): BSSID of the ESSID, essid (string): ESSID, radio_band (string): Radio band, radio (string): Radio band, security (string): the security policy of the SSID, enabled (boolean): , encryption (string): , portal_id (integer): , } slot_module { slot (integer): Module slot, hw_ver (string): Module hardware version, sn (string): Module S/N, model (string): Module model, product_name (string): Module product name, expiry_date (string): Module expiry date and time, }
{ "resp_code": "", "caller_ref": "", "server_ref": "", "message": "", "data": [ { "client_id": "", "mac": "", "device": { "id": 0, "group_id": 0, "group_name": "", "sn": "", "name": "", "status": "", "usage": 0.0, "tx": 0.0, "rx": 0.0, "product_id": 0, "client_count": 0, "fw_ver": "", "last_online": "", "offline_at": "", "first_appear": "", "lan_mac": "", "config_rollback": true, "config_rollback_date": "", "ic2_config_apply_locked": true, "outstanding_patch_ids": [ "" ], "device_config_apply_locked": true, "sp_default": true, "product_name": "", "product_code": "", "mv": "", "tags": [ "" ], "tag_info": [ { "id": 0, "name": "" } ], "note": "", "longitude": 0.0, "latitude": 0.0, "address": "", "location_timestamp": "", "follow_loc_dev": 0, "follow_loc_dev_info": { "id": 0, "sn": "", "name": "", "onlineStatus": "" }, "isStatic": true, "expiry_date": "", "sub_expiry_date": "", "prime_expiry_date": "", "prime_type": 0, "expired": true, "sub_expired": true, "gps_support": true, "gps_exist": true, "support_ssid_count": 0.0, "radio_modules": [ { "module_id": 0, "frequency_band": "", "active_frequency_band": "" } ], "group_type": "", "device_type": "", "last_sync_date": "", "v6_license": "", "uptime": 0, "uptime_appear": "", "fw_pending_trial_round": 0, "fw_pending_max_no_of_trial": 0, "fw_pending_ver": "", "fw_pending_schedule_time": "", "fw_pending_upgrade_time": "", "fw_pending_status": 0, "fw_pending_group_time": "", "is_master_device": true, "fw_managmed": "", "wifi_cfg": "", "ddns_enabled": true, "ddns_available": true, "ddns_letsencrypt_enabled": true, "ddns_letsencrypt_cert_expiry_date": "", "ddns_letsencrypt_apply_date": "", "onlineStatus": "", "wtp_ip": "", "interfaces": [ { "id": 0, "type": "", "status": "", "last_status": "", "name": "", "ddns_host": "", "ddns_name": "", "ddns_enabled": true, "dns_servers": [ "" ], "ip_status": "", "conn_len": 0, "ip": "", "netmask": "", "is_enable": true, "conn_mode": 0, "port_type": 0, "gateway": "", "mtu": 0.0, "healthcheck": "", "sims": { "imsi": "", "iccid": "", "status": "", "active": true, "bandwidthAllowanceMonitor": { "enable": true } }, "meid_hex": "", "esn": "", "imei": "", "imei_cdf": "", "apn": "", "username": "", "password": "", "dialnum": "", "carrier_name": "", "carrier_settings": "", "s2g3glte": "", "signal_bar": 0, "gobi_data_tech": "", "gobi_band_class_name": "", "gobi_band_2_class_name": "", "cellular_signals": { "rssi": 0.0, "sinr": 0.0, "rsrp": 0.0, "rsrq": 0.0 }, "gobi_band_2_cellular_signals": { "rssi": 0.0, "sinr": 0.0, "rsrp": 0.0, "rsrq": 0.0 }, "cell_id": 0, "adaptor_type": "", "vendor_id": 0, "product_id": 0, "modem_name": "", "modem_manufacturer": "", "status_led": "", "is_overall_up": 0, "standby_state": "", "mtu_state": 0, "healthy_state": 0, "connection_state": 0, "physical_state": 0, "is_backup": 0, "is_quota_exceed": 0, "is_manual_disconnect": 0, "conn_config_method": "", "standby_mode": "", "mtu_config": 0, "group": 0, "updated_at": "" } ], "vlan_interfaces": [ { "vlan_id": 0, "vlan_ip": "", "netmask": "", "name": "", "icmg": true, "portal_id": 0, "portal_name": "", "portal_enabled": true } ], "ssid_profiles": [ { "tags": [ { "id": 0, "name": "" } ], "exempt_tags": [ { "id": 0, "name": "" } ], "fast_transition": true, "acl_id": 0, "access_control_list": { "id": 0, "group_id": 0, "name": "", "address": [ "" ], "referenced_by": [ { "type": "", "id": 0, "name": "", "device_id": 0, "group_id": 0 } ] }, "device_select": "", "portal_id": 0, "access_mode": [ "" ], "id": 0, "enabled": true, "ssid": "", "security": "", "wep": { "key_format": "", "key_size": 0, "encrypt_key": "", "shared_key_auth": true }, "layer2_isolation": true, "mac_filter": "", "mac_list": [ "" ], "multicast_filter": true, "multicast_rate": "", "broadcast": true, "icMg": true, "vlan_id": 0, "radio_band": "", "radio_select": "", "band_steering": "", "igmp_snooping": true, "portal_enabled": true, "portal_url": "", "portal_cacheId": "", "portal_auth": "", "portal_cna_bypass": true, "portal_domain_accept": "", "portal_idle_sec": 0, "portal_inactive_timeout": 0, "portal_logout_kick": true, "radius_nasid_type": "", "radius_nasid_custom": "", "bandwidth_control": true, "client_bandwidth_upstream": 0, "client_bandwidth_downstream": 0, "bandwidth_upstream": 0, "bandwidth_downstream": 0, "block_lan_access": true, "block_custom_subnet": true, "block_custom_subnet_list": "", "block_except": true, "block_except_list": "", "block_mvpn": true, "client_limit": 0, "client_limit_5g": 0, "qos": 0, "wpa_personal": { "psk_enable": true, "shared_key": "", "shared_key_type": "", "shared_key_random_prefix": "", "shared_key_random_alphas": 0, "shared_key_random_digits": 0, "regenerate_shared_key": true, "regenerate_shared_key_device_tags": [ 0 ] }, "schedule_id": 0, "portal_custom": true, "radius_servers": [ { "id": 0, "host": "", "secret": "", "auth_port": 0, "account_port": 0, "radius_nasid_type": "", "radius_nasid_custom": "" } ] } ], "ssid_profiles_applied": [ { "id": 0, "ssid": "", "group_id": 0, "device_id": 0, "portal_id": 0, "enabled": true, "icMg": true, "vlan_id": 0, "portal_custom": true, "wpa_passphrase": "" } ], "hardware_version": "", "mvpn_version": "", "radio_bands": [ { "radio_bands": 0, "active_band": "", "txpower": 0.0, "channel": 0, "channel_mode": "" } ], "loc_display": true, "extap_proxy_supported": true, "extap_proxy_enabled": true, "wlan_probe_supported": true, "wlan_probe_enabled": true, "dpi_supported": true, "dpi_enabled": true, "low_data_usage_mode": true, "ra_enabled": true, "watchdog_enabled": true, "ra_supported": true, "watchdog_supported": true, "ap_router_mode": true, "ssid_mac_list": [ { "bssid": "", "essid": "", "radio": "", "security": "" } ], "site_id": "", "handshake_port": true, "refuse_legacy": true, "peer_connections": 0, "pepvpn_peers": 0, "is_default_password": true, "is_apply_bulk_config": true, "is_wlan_ap_suspended": true, "is_ap_schedule_enabled": true, "is_ha_enabled": true, "is_ha_slave": true, "ha_role": "", "ha_status": "", "ha_transition_time": "", "periph_status_available": true, "periph_status": { "cpu_load": { "name": "", "value": 0.0, "total": 0.0, "voltage": 0.0, "current": 0.0, "percentage": 0.0, "active": true }, "power_state": { "name": "", "connect": true }, "power_usage": { "name": "", "value": 0.0, "total": 0.0, "voltage": 0.0, "current": 0.0, "percentage": 0.0, "active": true }, "fan_speed": { "name": "", "value": 0.0, "total": 0.0, "voltage": 0.0, "current": 0.0, "percentage": 0.0, "active": true }, "thermal_sensor": { "temperature": 0.0, "max": 0.0, "threshold": 0.0, "min": 0.0 } }, "port_status_available": true, "port_status": {}, "gobi_sim_lock_supported": true, "gobi_sim_locks": [ "" ], "poe_supported": true, "admin_conf": { "managed": true, "protocol": "", "admin_auth": "", "admin_user_auth": "", "version": 0, "admin_name": "", "admin_password": "", "admin_readonly_name": "", "admin_readonly_password": "", "admin_radius_enable": true }, "outbound_policy_managed": true, "firewall_rules_managed": true, "is_apply_import_lan": true, "is_apply_csv_override": true, "is_wlc_enabled": true, "mgnt_incontrol_vlan_ip": "", "mgnt_incontrol_vlan": 0, "mgnt_incontrol_vlan_gateway": "", "mgnt_incontrol_vlan_dns": [ "" ], "mgnt_incontrol_vlan_connection_type": "", "mgnt_vlan_ip": "", "mgnt_vlans": [ { "vlan_id": 0, "vlan_ip": "", "netmask": "", "name": "", "icmg": true, "portal_id": 0, "portal_name": "", "portal_enabled": true } ], "max_lacp_group_support": 0, "max_port_per_lacp_group": 0, "endpoint_support": true, "slow_response": true, "slow_response_start_time": "", "wlan_mac_list": [ { "bssid": "", "essid": "", "radio_band": "", "radio": "", "security": "", "enabled": true, "encryption": "", "portal_id": 0 } ], "slot_module_list": [ { "slot": 0, "hw_ver": "", "sn": "", "model": "", "product_name": "", "expiry_date": "" } ], "vlan_managed": true, "icmg_mvpn": true, "icmg_wan": true, "icmg_schedule_reboot": true, "icmg_schedule": true, "icmg_wlan": true, "icmg_portal": true, "icmg_lan": true, "icmg_sdswitch": true, "icmg_outbound": true, "icmg_firewall": true, "icmg_admin": true }, "duration": 0, "connection_type": "", "status": "", "ssid": "", "channel": 0, "ip": "", "channel_width": 0.0, "radio_mode": "", "signal": 0.0, "longitude": 0.0, "latitude": 0.0, "radius": 0.0, "last_seen": "" } ] }
Field | Type | Description |
---|---|---|
resp_code | string |
Response code
SUCCESS, INVALID_INPUT, INTERNAL_ERROR, PENDING |
caller_ref | string |
Caller reference identifier, auto generated if not specified
|
server_ref | string |
Server reference identifier, generated on server side
|
message | string |
Response message
|
data | array[client] |
Response data object
|
Field | Type | Description |
---|---|---|
client_id | string |
Unique identifier of the client
|
mac | string |
MAC address
|
device | device |
The device the client currently attached to
|
duration | integer |
Wi-Fi connection duration in seconds
|
connection_type | string |
Connected via Wi-Fi or Ethernet
wireless, ethernet |
status | string |
Online status
active, inactive |
ssid | string |
SSID the client connected to
|
channel | integer |
Wi-Fi channel of the client connection
|
ip | string |
IP address
|
channel_width | number |
Wi-Fi channel width
|
radio_mode | string |
Wi-Fi radio mode
|
signal | number |
Signal strength
|
longitude | number |
Location longitude
|
latitude | number |
Location latitude
|
radius | number |
The distance from the longitude and latitude the client could locate
|
last_seen | string |
Last seen date and time of the client
|
Field | Type | Description |
---|---|---|
id | integer |
Unique identifier of the device
|
group_id | integer |
Unique identifier of the group
|
group_name | string |
Name of the group
|
sn | string |
Device S/N
|
name | string |
Device name
|
status | string |
Device status
online, offline |
usage | number |
Current bandwidth usage
|
tx | number |
Current upload usage
|
rx | number |
Current download usage
|
product_id | integer |
Unique identifier of the product
|
client_count | integer |
Current client count
|
fw_ver | string |
Firmware version using
|
last_online | string |
Last online date and time
|
offline_at | string |
Last offline date and time
|
first_appear | string |
First appeared date and time
|
lan_mac | string |
LAN MAC address
|
config_rollback | boolean |
Indicates if the recent change in outbound policy or firewall rules applied from InControl has been rolled back as the device was unable to reach InControl.
|
config_rollback_date | string |
Config roll back date and time
|
ic2_config_apply_locked | boolean |
Indicates if the device is "Config Locked" by InControl
|
outstanding_patch_ids | array[string] |
Unique identifier of the outstanding configuration patches
|
device_config_apply_locked | boolean |
Indicates if the device is "Config Locked" by device
|
sp_default | boolean |
Indicates if the active configuration is saved as SP default
|
product_name | string |
Product name
|
product_code | string |
Product code
|
mv | string |
Model variant
|
tags | array[string] |
List of Device tags name
|
tag_info | array[tag_info] |
List of Device tags information
|
note | string |
Note
|
longitude | number |
Location longitude
|
latitude | number |
Location latitude
|
address | string |
Location address
|
location_timestamp | string |
Location recorded time
|
follow_loc_dev | integer |
Device's ID of the followed location device
|
follow_loc_dev_info | follow_loc_dev_info |
Followed location device information
|
isStatic | boolean |
Indicates if the returned location is a static one
|
expiry_date | string |
Warranty expiry date
|
sub_expiry_date | string |
Subscription expiry date
|
prime_expiry_date | string |
Prime expiry date
|
prime_type | integer |
Prime Type: 1 - with prime subscription, 0 or undefined - without prime subscription
0, 1 |
expired | boolean |
Indicates if the device warranty has expired
|
sub_expired | boolean |
Indicates if the device subscription has expired
|
gps_support | boolean |
Indicates if the device support gps
|
gps_exist | boolean |
Indicates if the device with any gps records
|
support_ssid_count | number |
Supported number of SSIDs
|
radio_modules | array[radio_module] |
Supported radio modules
|
group_type | string |
Group type
peplink |
device_type | string |
Device type
|
last_sync_date | string |
Last config applied date and time
|
v6_license | string |
Indicates if the device has activated firmware 6.x license
enabled, disabled |
uptime | integer |
Device up time
|
uptime_appear | string |
Retrieval time of the device up time
|
fw_pending_trial_round | integer |
Firmware update trial count
|
fw_pending_max_no_of_trial | integer |
Maximum number of firmware update trial count
|
fw_pending_ver | string |
Version of the firmware to be updated
|
fw_pending_schedule_time | string |
Scheduled firmware update start time
|
fw_pending_upgrade_time | string |
Actual firmware update time
|
fw_pending_status | integer |
Firmware update status, 1 - active, 0 - inactive
0, 1 |
fw_pending_group_time | string |
Pending firmware update time in the group's time zone
|
is_master_device | boolean |
Indicates if the device is a master configuration cloning device
|
fw_managmed | string |
(only for device detail call) Indicates if the firmware is managed by organization level, group level or device level
|
wifi_cfg | string |
Indicates the device follows group or device level's SSID settings, or locally managed on the device
group, device, not_managed |
ddns_enabled | boolean |
Indicates if "Find My Peplink Service" enabled
|
ddns_available | boolean |
Indicates if "Find My Peplink Service" available
|
ddns_letsencrypt_enabled | boolean |
Indicates if "Manage Web Admin SSL Certificate" is enabled for "Find My Peplink Service"
|
ddns_letsencrypt_cert_expiry_date | string |
Web Admin SSL certificate expiry date and time
|
ddns_letsencrypt_apply_date | string |
Web Admin SSL certificate apply date and time
|
onlineStatus | string |
Current online status
|
wtp_ip | string |
Last Detected IP
|
interfaces | array[interface] |
Device interfaces
|
vlan_interfaces | array[vlan_interface] |
VLAN interfaces
|
ssid_profiles | array[ssid_profile] |
SSID profiles
|
ssid_profiles_applied | array[ssid_profiles_applied] |
Applied SSID profiles
|
hardware_version | string |
Hardware version
|
mvpn_version | string |
MVPN version
|
radio_bands | array[radio_band] |
Radio bands
|
loc_display | boolean |
Indicates if address displayed on "Location" field in InControl Device Detail Page: true - display address, false - display latitude/longitude
|
extap_proxy_supported | boolean |
Indicates if the device is a AP controller
|
extap_proxy_enabled | boolean |
Indicates if the device is a managed by AP controller
|
wlan_probe_supported | boolean |
Indicates if the device supports "Collecting Wi-Fi Analytics Data"
|
wlan_probe_enabled | boolean |
Indicates if the device enabled "Collecting Wi-Fi Analytics Data" in InControl
|
dpi_supported | boolean |
Indicates if the device supports deep packet inspection
|
dpi_enabled | boolean |
Indicates if the device enabled deep packet inspection
|
low_data_usage_mode | boolean |
Indicates if the device enabled low data usage mode
|
ra_enabled | boolean |
Indicates if the device enabled remote assistance
2.8.3 |
watchdog_enabled | boolean |
Indicates if the device enabled hardware watchdog
2.8.3 |
ra_supported | boolean |
Indicates if the device support remote assistance
2.8.3 |
watchdog_supported | boolean |
Indicates if the device support hardware watchdog
2.8.3 |
ap_router_mode | boolean |
Indicates if the device applied router mode, true - router mode, false - bridge mode
|
ssid_mac_list | array[ssid_mac_list] |
SSID mac list
|
site_id | string |
PepVPN Site ID
|
handshake_port | boolean |
(PepVPN / SpeedFusion) Handshake port
|
refuse_legacy | boolean |
(PepVPN / SpeedFusion) Indicates if the device accept connections from legacy firmware
|
peer_connections | integer |
PepVPN / SpeedFusion Peer Connections
|
pepvpn_peers | integer |
Maximum number of PepVPN / SpeedFusion Peer Connections
|
is_default_password | boolean |
Indicates if default password is used in device web admin
|
is_apply_bulk_config | boolean |
Indicates if the device is applied with bulk config
|
is_wlan_ap_suspended | boolean |
Indicates if the device WLAN AP is suspended
|
is_ap_schedule_enabled | boolean |
Indicates if the device AP schedule enabled
|
is_ha_enabled | boolean |
Indicates if high availability enabled
|
is_ha_slave | boolean |
Indicates if the device is a high availability slave unit
|
ha_role | string |
High Availability Preferred Role (master|slave)
|
ha_status | string |
High Availability Status
|
ha_transition_time | string |
Last Transition Date and time
|
periph_status_available | boolean |
Indicates if periph status is available
|
periph_status | periph_status |
Periph status
|
port_status_available | boolean |
Indicates if port status is available
|
port_status | port_status |
Port status
|
gobi_sim_lock_supported | boolean |
Indicates if the device support SIM lock
|
gobi_sim_locks | array[string] | |
poe_supported | boolean |
Indicates if the device support poe
|
admin_conf | admin_conf |
Admin configuration
|
outbound_policy_managed | boolean | |
firewall_rules_managed | boolean | |
is_apply_import_lan | boolean | |
is_apply_csv_override | boolean | |
is_wlc_enabled | boolean | |
mgnt_incontrol_vlan_ip | string | |
mgnt_incontrol_vlan | integer | |
mgnt_incontrol_vlan_gateway | string | |
mgnt_incontrol_vlan_dns | array[string] | |
mgnt_incontrol_vlan_connection_type | string | |
mgnt_vlan_ip | string | |
mgnt_vlans | array[vlan_interface] | |
max_lacp_group_support | integer | |
max_port_per_lacp_group | integer | |
endpoint_support | boolean | |
slow_response | boolean | |
slow_response_start_time | string | |
wlan_mac_list | array[wlan_mac_list] | |
slot_module_list | array[slot_module] |
List of slot module information
|
vlan_managed | boolean |
(device detail) Indicates if the device has VLAN managed
|
icmg_mvpn | boolean | |
icmg_wan | boolean |
Indicates if Device WAN settings is managed by InControl
|
icmg_schedule_reboot | boolean |
Indicates if the device is applying Device Schedule Reboot
|
icmg_schedule | boolean |
Indicates if the device is applying Device Schedule
|
icmg_wlan | boolean |
Indicates if SSID and Radio settings is managed by InControl
|
icmg_portal | boolean |
Indicates if Captive Portal is managed by InControl
|
icmg_lan | boolean |
Indicates if Device LAN IP settings is managed by InControl
|
icmg_sdswitch | boolean | |
icmg_outbound | boolean |
Indicates if Outbound Policy managed by InControl
|
icmg_firewall | boolean |
Indicates if Firewall Rules is managed by InControl
|
icmg_admin | boolean |
Indicates if device web admin management is managed by InControl
|
Field | Type | Description |
---|---|---|
id | integer |
Unique identifier of the device tag
|
name | string |
Device tag name
|
Field | Type | Description |
---|---|---|
id | integer |
Unique identifier of the followed device
|
sn | string |
S/N of the followed device
|
name | string |
Device name of the followed device
|
onlineStatus | string |
Online status of the followed device
|
Field | Type | Description |
---|---|---|
module_id | integer |
System generated Wi-Fi radio module identifier
|
frequency_band | string |
Supported radio frequency bands
|
active_frequency_band | string |
The active frequency band
|
Field | Type | Description |
---|---|---|
id | integer |
System generated interface identifier
|
type | string |
Interface type
|
status | string |
Interface status for InControl, Connected|Disconnected|Disabled|No SIM Card Detected|No Cable Detected
|
last_status | string |
Wan status, Only exists if the device is offline
|
name | string |
Interface name
|
ddns_host | string |
DDNS host
|
ddns_name | string |
Find My Peplink Address
|
ddns_enabled | boolean |
Indicates if DDNS is enabled
|
dns_servers | array[string] |
List of dns servers
|
ip_status | string | |
conn_len | integer | |
ip | string |
IP
|
netmask | string |
Netmask
|
is_enable | boolean |
Indicates if the interface is enabled
|
conn_mode | integer |
Routing mode
|
port_type | integer |
Port type
|
gateway | string |
Default gateway
|
mtu | number |
MTU
|
healthcheck | string |
Health check method, "nslookup" - DNS Lookup, "pstr" - SmartCheck, "disabled" - Disabled, "ping" - PING, "http" - HTTP
|
sims | interface_sims |
SIMs info
|
meid_hex | string |
MEID DEC
|
esn | string |
ESN
|
imei | string |
IMEI
|
imei_cdf | string |
Cellular Module
|
apn | string |
APN
|
username | string |
Username for APN
|
password | string |
Password for APN
|
dialnum | string |
Dial Number for APN
|
carrier_name | string |
Carrier
|
carrier_settings | string |
Carrier settings
|
s2g3glte | string |
Indicates if the network is "3G", "4G" or "LTE"
|
signal_bar | integer |
Indicates the signal bar level, -1: no signal, 0-5: signal bar level
|
gobi_data_tech | string |
Network
|
gobi_band_class_name | string |
Network band
|
gobi_band_2_class_name | string |
Secondary band
|
cellular_signals | interface_cellular_signals |
Cellular signals
|
gobi_band_2_cellular_signals | interface_cellular_signals |
Cellular signals
|
cell_id | integer |
Cell ID
|
adaptor_type | string |
Modem adaptor type
|
vendor_id | integer |
Modem adaptor vendor ID
|
product_id | integer |
Modem adaptor product ID
|
modem_name | string |
Modem adaptor name
|
modem_manufacturer | string |
Modem adaptor manufacturer
|
status_led | string |
Indicates the interface status in color in InControl
|
is_overall_up | integer | |
standby_state | string |
Standby state, connected|disconnect
|
mtu_state | integer | |
healthy_state | integer | |
connection_state | integer |
Connection state
|
physical_state | integer |
Physical state
|
is_backup | integer | |
is_quota_exceed | integer | |
is_manual_disconnect | integer | |
conn_config_method | string |
Connection Method
|
standby_mode | string |
Standby mode
|
mtu_config | integer |
MTU config
|
group | integer |
Indicates the priority group id
|
updated_at | string |
Interface info updated date and time
|
Field | Type | Description |
---|---|---|
imsi | string |
IMSI
|
iccid | string |
ICCID
|
status | string |
SIM Status
|
active | boolean |
Indicates if the SIM is active
|
bandwidthAllowanceMonitor | interface_sims_bandwdith_allowance_monitor |
Bandwidth allowance monitor information of the WAN connection or SIM
|
Field | Type | Description |
---|---|---|
enable | boolean |
Indicates if the bandwidth allowance monitor is enabled
|
Field | Type | Description |
---|---|---|
rssi | number |
Signal Strength in RSSI (dBm)
|
sinr | number |
Signal Quality in SINR (dB)
|
rsrp | number |
Signal Strength in RSRP (dBm)
|
rsrq | number |
Signal Quality in RSRQ (dB)
|
Field | Type | Description |
---|---|---|
vlan_id | integer |
VLAN ID
|
vlan_ip | string |
VLAN IP
|
netmask | string |
VLAN netmask
|
name | string |
VLAN name
|
icmg | boolean |
Indicates if the VLAN is managed by InControl
|
portal_id | integer |
Unique identifier of VLAN portal
|
portal_name | string |
Name of the VLAN portal
|
portal_enabled | boolean |
Indicates if the VLAN portal is enabled
|
Field | Type | Description |
---|---|---|
tags | array[tag_info] |
Device tag selected
|
exempt_tags | array[tag_info] |
Device tag exempted
|
fast_transition | boolean |
Indicates if Fast Transition is enabled
|
acl_id | integer |
Unique identifier of the Access Control List applied
|
access_control_list | access_control_list |
Access Control List
|
device_select | string |
Device Selection
disable, enable, exempt |
portal_id | integer |
Unique identifier of the applied captive portal
|
access_mode | array[string] |
Access mode of the applied captive portal
|
id | integer |
Unique identifier of the SSID profile
|
enabled | boolean |
Indicates if the SSID profile is enabled
|
ssid | string |
SSID
|
security | string |
SSID security type
open, wpa_wpa2_personal, wpa_wpa2_enterprise |
wep | wep_settings |
WEP Security settings
|
layer2_isolation | boolean |
Indicates if Layer 2 Isolation is enabled
|
mac_filter | string |
MAC address filtering type
none, deny, allow |
mac_list | array[string] |
MAC Address List
|
multicast_filter | boolean |
Indicates if multicast Filter is enabled
|
multicast_rate | string |
Multicast Rate
mcs0, mcs1, mcs2, mcs3, mcs4, mcs5, mcs6, mcs7 |
broadcast | boolean |
Indicates whether SSID is broadcasted, otherwise hidden
|
icMg | boolean |
Indicates if the SSID profile is managed in InControl
|
vlan_id | integer |
VLAN ID
|
radio_band | string |
Radio Band(s) the SSID is available on
2_4ghz, 5ghz, dual |
radio_select | string |
Radio Band selected, 1 - 2.4ghz, 2 - 5ghz, 3 - both
|
band_steering | string |
Band Steering, Default value: 'preferred'
disable, preferred, forced |
igmp_snooping | boolean |
Indicates if IGMP snooping is enabled
|
portal_enabled | boolean |
Indicates if captive portal is applied for the SSID profile
|
portal_url | string | |
portal_cacheId | string | |
portal_auth | string | |
portal_cna_bypass | boolean | |
portal_domain_accept | string | |
portal_idle_sec | integer | |
portal_inactive_timeout | integer | |
portal_logout_kick | boolean | |
radius_nasid_type | string |
NAS-Identifier in RADUIS server settings
device_name, lan_mac, sn, custom |
radius_nasid_custom | string |
NAS-Identifier custom value in RADUIS server settings
|
bandwidth_control | boolean | |
client_bandwidth_upstream | integer |
Per client upstream limit in kbps (0: Unlimited) (Pepwave AP only)
|
client_bandwidth_downstream | integer |
Per client downstream limit in kbps (0: Unlimited) (Pepwave AP only)
|
bandwidth_upstream | integer |
Upstream limit in kbps (0: Unlimited) (Pepwave AP only)
|
bandwidth_downstream | integer |
Downstream limit in kbps (0: Unlimited) (Pepwave AP only)
|
block_lan_access | boolean |
Indicates if Block LAN Access is enabled (Pepwave AP only)
|
block_custom_subnet | boolean |
Indicates if Custom Subnet is applied
|
block_custom_subnet_list | string |
Custom Subnet (Pepwave AP only)
|
block_except | boolean |
Indicates if Block Exception is applied
|
block_except_list | string |
Block Exception (Pepwave AP only)
|
block_mvpn | boolean |
Indicates Block PepVPN is enabled
|
client_limit | integer |
Maximum number of clients for 2.4 GHz
|
client_limit_5g | integer |
Maximum number of clients for 5 GHz
|
qos | integer |
Network Priority (QoS), 0 - Gold, 1 - Silver, 2 - Bronze
|
wpa_personal | wpa_personal_settings |
WPA/WPA2 Security settings
|
schedule_id | integer |
Device schedule
|
portal_custom | boolean |
Indicates if external captive portal is applied for the SSID profile
|
radius_servers | array[radius_server] |
List of RADIUS Server settings
|
Field | Type | Description |
---|---|---|
id | integer |
Unique identifier of the access control list
|
group_id | integer |
Unique identifier of the group
|
name | string |
Name of the access control list
|
address | array[string] |
List of MAC addresses
|
referenced_by | array[access_control_list_referenced_by] |
List of access control list reference by object, Only appears when with_reference=true
|
Field | Type | Description |
---|---|---|
type | string |
Type of reference object
firewall, outbound, ssid, portal, custom_portal |
id | integer |
Unique identifier of the reference object
|
name | string |
Name of the reference object
|
device_id | integer |
Unique identifier of the device
|
group_id | integer |
Unique identifier of the group
|
Field | Type | Description |
---|---|---|
key_format | string |
Key Format
ASCII, HEX |
key_size | integer |
Key size
|
encrypt_key | string |
Encryption key.
|
shared_key_auth | boolean |
Indicates whether shared key authentication is enabled
|
Field | Type | Description |
---|---|---|
psk_enable | boolean |
Indicates whether pre-shared key is enabled
|
shared_key | string |
The pre-shared key
|
shared_key_type | string |
Shared Key Option
"static" - Static shared key "lan_mac" - Last 8 octets of LAN MAC address "random" - Random static, lan_mac, random |
shared_key_random_prefix | string |
required when shared_key_type=random, Prefix in generated shared key
|
shared_key_random_alphas | integer |
required when shared_key_type=random, Number of alphabets generated in shared key
|
shared_key_random_digits | integer |
required when shared_key_type=random, Number of digits generated in shared key
|
regenerate_shared_key | boolean |
when update a SSID profile, Indicates if regenerate key is enabled
|
regenerate_shared_key_device_tags | array[integer] |
when update a SSID profile, List of device tags IDs applied for the regenerate key
|
Field | Type | Description |
---|---|---|
id | integer |
RADIUS server identifier
|
host | string |
Server host name
|
secret | string |
Server secret
|
auth_port | integer |
RADIUS server authentication port
|
account_port | integer |
RADIUS server accounting port
|
radius_nasid_type | string |
NAS-Identifier, Default: device_name
device_name, sn, lan_mac, custom |
radius_nasid_custom | string |
NAS-Identifier custom value, required when radius_nasid_type=custom
|
Field | Type | Description |
---|---|---|
id | integer |
System generated SSID profile identifier
|
ssid | string |
SSID
|
group_id | integer |
Unique identifier of the group
|
device_id | integer |
Unique identifier of the device
|
portal_id | integer |
Unique identifier of the captive portal/external captive portal
|
enabled | boolean |
Indicates if the ssid profile is enabled
|
icMg | boolean |
Indicates if the ssid profile is managed by InControl
|
vlan_id | integer |
VLAN ID
|
portal_custom | boolean |
Indicates if the portal is external captive portal
|
wpa_passphrase | string |
WPA passphrase, the field would be hidden for read-only users
|
Field | Type | Description |
---|---|---|
radio_bands | integer |
Unique identifier of the radio band
|
active_band | string |
The active frequency band
|
txpower | number |
Output power
|
channel | integer |
Channel
|
channel_mode | string |
Channel Mode
|
Field | Type | Description |
---|---|---|
bssid | string |
BSSID of the ESSID
|
essid | string |
ESSID
|
radio | string |
Radio band
|
security | string |
the security policy of the SSID
|
Field | Type | Description |
---|---|---|
cpu_load | usage_data |
CPU load
|
power_state | power_state |
Power State
|
power_usage | usage_data |
Power Usage
|
fan_speed | usage_data |
Fan speed
|
thermal_sensor | temperature |
Thermal Sensor
|
Field | Type | Description |
---|---|---|
name | string |
Name
|
value | number |
Value
|
total | number |
Total
|
voltage | number |
Voltage
|
current | number |
Current
|
percentage | number |
Percentage
|
active | boolean |
Active
|
Field | Type | Description |
---|---|---|
name | string |
Name
|
connect | boolean |
Indicates if the power is connected
|
Field | Type | Description |
---|---|---|
temperature | number |
Temperature
|
max | number |
Maximum
|
threshold | number |
Threshold
|
min | number |
Minimum
|
Field | Type | Description |
---|
Field | Type | Description |
---|---|---|
managed | boolean |
Indicates if device web admin management is enabled
|
protocol | string | |
admin_auth | string | |
admin_user_auth | string | |
version | integer | |
admin_name | string |
Admin User Name
|
admin_password | string |
Admin password
|
admin_readonly_name | string |
Read-only User Name
|
admin_readonly_password | string |
Read-only User password
|
admin_radius_enable | boolean |
Indicates if Authentication by RADIUS is enabled
|
Field | Type | Description |
---|---|---|
bssid | string |
BSSID of the ESSID
|
essid | string |
ESSID
|
radio_band | string |
Radio band
|
radio | string |
Radio band
|
security | string |
the security policy of the SSID
|
enabled | boolean | |
encryption | string | |
portal_id | integer |
Field | Type | Description |
---|---|---|
slot | integer |
Module slot
|
hw_ver | string |
Module hardware version
|
sn | string |
Module S/N
|
model | string |
Module model
|
product_name | string |
Module product name
|
expiry_date | string |
Module expiry date and time
|
Parameters
Response Content Type:
Parameters
text/csv
Parameters
GET
/rest/o/{organization_id}/g/{group_id}/client/{client_id}
Get a client's information in group level
Response Content Type:
Model Schema
Model | Response Sample | Model Description
[expand] | [collapse]
[expand] | [collapse]
[expand] | [collapse]
Parameters
application/json
Model Schema
Model | Response Sample | Model Description
response { resp_code (string): Response code, caller_ref (string): Caller reference identifier, auto generated if not specified, server_ref (string): Server reference identifier, generated on server side, message (string): Response message, data (client): Response data object, } client { client_id (string): Unique identifier of the client, mac (string): MAC address, device (device): The device the client currently attached to, duration (integer): Wi-Fi connection duration in seconds, connection_type (string): Connected via Wi-Fi or Ethernet, status (string): Online status, ssid (string): SSID the client connected to, channel (integer): Wi-Fi channel of the client connection, ip (string): IP address, channel_width (number): Wi-Fi channel width, radio_mode (string): Wi-Fi radio mode, signal (number): Signal strength, longitude (number): Location longitude, latitude (number): Location latitude, radius (number): The distance from the longitude and latitude the client could locate, last_seen (string): Last seen date and time of the client, } device { id (integer): Unique identifier of the device, group_id (integer): Unique identifier of the group, group_name (string): Name of the group, sn (string): Device S/N, name (string): Device name, status (string): Device status, usage (number): Current bandwidth usage, tx (number): Current upload usage, rx (number): Current download usage, product_id (integer): Unique identifier of the product, client_count (integer): Current client count, fw_ver (string): Firmware version using, last_online (string): Last online date and time, offline_at (string): Last offline date and time, first_appear (string): First appeared date and time, lan_mac (string): LAN MAC address, config_rollback (boolean): Indicates if the recent change in outbound policy or firewall rules applied from InControl has been rolled back as the device was unable to reach InControl., config_rollback_date (string): Config roll back date and time, ic2_config_apply_locked (boolean): Indicates if the device is "Config Locked" by InControl, outstanding_patch_ids (array[string]): Unique identifier of the outstanding configuration patches, device_config_apply_locked (boolean): Indicates if the device is "Config Locked" by device, sp_default (boolean): Indicates if the active configuration is saved as SP default, product_name (string): Product name, product_code (string): Product code, mv (string): Model variant, tags (array[string]): List of Device tags name, tag_info (array[tag_info]): List of Device tags information, note (string): Note, longitude (number): Location longitude, latitude (number): Location latitude, address (string): Location address, location_timestamp (string): Location recorded time, follow_loc_dev (integer): Device's ID of the followed location device, follow_loc_dev_info (follow_loc_dev_info): Followed location device information, isStatic (boolean): Indicates if the returned location is a static one, expiry_date (string): Warranty expiry date, sub_expiry_date (string): Subscription expiry date, prime_expiry_date (string): Prime expiry date, prime_type (integer): Prime Type: 1 - with prime subscription, 0 or undefined - without prime subscription, expired (boolean): Indicates if the device warranty has expired, sub_expired (boolean): Indicates if the device subscription has expired, gps_support (boolean): Indicates if the device support gps, gps_exist (boolean): Indicates if the device with any gps records, support_ssid_count (number): Supported number of SSIDs, radio_modules (array[radio_module]): Supported radio modules, group_type (string): Group type, device_type (string): Device type, last_sync_date (string): Last config applied date and time, v6_license (string): Indicates if the device has activated firmware 6.x license, uptime (integer): Device up time, uptime_appear (string): Retrieval time of the device up time, fw_pending_trial_round (integer): Firmware update trial count, fw_pending_max_no_of_trial (integer): Maximum number of firmware update trial count, fw_pending_ver (string): Version of the firmware to be updated, fw_pending_schedule_time (string): Scheduled firmware update start time, fw_pending_upgrade_time (string): Actual firmware update time, fw_pending_status (integer): Firmware update status, 1 - active, 0 - inactive, fw_pending_group_time (string): Pending firmware update time in the group's time zone, is_master_device (boolean): Indicates if the device is a master configuration cloning device, fw_managmed (string): (only for device detail call) Indicates if the firmware is managed by organization level, group level or device level, wifi_cfg (string): Indicates the device follows group or device level's SSID settings, or locally managed on the device, ddns_enabled (boolean): Indicates if "Find My Peplink Service" enabled, ddns_available (boolean): Indicates if "Find My Peplink Service" available, ddns_letsencrypt_enabled (boolean): Indicates if "Manage Web Admin SSL Certificate" is enabled for "Find My Peplink Service", ddns_letsencrypt_cert_expiry_date (string): Web Admin SSL certificate expiry date and time, ddns_letsencrypt_apply_date (string): Web Admin SSL certificate apply date and time, onlineStatus (string): Current online status, wtp_ip (string): Last Detected IP, interfaces (array[interface]): Device interfaces, vlan_interfaces (array[vlan_interface]): VLAN interfaces, ssid_profiles (array[ssid_profile]): SSID profiles, ssid_profiles_applied (array[ssid_profiles_applied]): Applied SSID profiles, hardware_version (string): Hardware version, mvpn_version (string): MVPN version, radio_bands (array[radio_band]): Radio bands, loc_display (boolean): Indicates if address displayed on "Location" field in InControl Device Detail Page: true - display address, false - display latitude/longitude, extap_proxy_supported (boolean): Indicates if the device is a AP controller, extap_proxy_enabled (boolean): Indicates if the device is a managed by AP controller, wlan_probe_supported (boolean): Indicates if the device supports "Collecting Wi-Fi Analytics Data", wlan_probe_enabled (boolean): Indicates if the device enabled "Collecting Wi-Fi Analytics Data" in InControl, dpi_supported (boolean): Indicates if the device supports deep packet inspection, dpi_enabled (boolean): Indicates if the device enabled deep packet inspection, low_data_usage_mode (boolean): Indicates if the device enabled low data usage mode, ra_enabled (boolean): Indicates if the device enabled remote assistance, watchdog_enabled (boolean): Indicates if the device enabled hardware watchdog, ra_supported (boolean): Indicates if the device support remote assistance, watchdog_supported (boolean): Indicates if the device support hardware watchdog, ap_router_mode (boolean): Indicates if the device applied router mode, true - router mode, false - bridge mode, ssid_mac_list (array[ssid_mac_list]): SSID mac list, site_id (string): PepVPN Site ID, handshake_port (boolean): (PepVPN / SpeedFusion) Handshake port, refuse_legacy (boolean): (PepVPN / SpeedFusion) Indicates if the device accept connections from legacy firmware, peer_connections (integer): PepVPN / SpeedFusion Peer Connections, pepvpn_peers (integer): Maximum number of PepVPN / SpeedFusion Peer Connections, is_default_password (boolean): Indicates if default password is used in device web admin, is_apply_bulk_config (boolean): Indicates if the device is applied with bulk config, is_wlan_ap_suspended (boolean): Indicates if the device WLAN AP is suspended, is_ap_schedule_enabled (boolean): Indicates if the device AP schedule enabled, is_ha_enabled (boolean): Indicates if high availability enabled, is_ha_slave (boolean): Indicates if the device is a high availability slave unit, ha_role (string): High Availability Preferred Role (master|slave), ha_status (string): High Availability Status, ha_transition_time (string): Last Transition Date and time, periph_status_available (boolean): Indicates if periph status is available, periph_status (periph_status): Periph status, port_status_available (boolean): Indicates if port status is available, port_status (port_status): Port status, gobi_sim_lock_supported (boolean): Indicates if the device support SIM lock, gobi_sim_locks (array[string]): , poe_supported (boolean): Indicates if the device support poe, admin_conf (admin_conf): Admin configuration, outbound_policy_managed (boolean): , firewall_rules_managed (boolean): , is_apply_import_lan (boolean): , is_apply_csv_override (boolean): , is_wlc_enabled (boolean): , mgnt_incontrol_vlan_ip (string): , mgnt_incontrol_vlan (integer): , mgnt_incontrol_vlan_gateway (string): , mgnt_incontrol_vlan_dns (array[string]): , mgnt_incontrol_vlan_connection_type (string): , mgnt_vlan_ip (string): , mgnt_vlans (array[vlan_interface]): , max_lacp_group_support (integer): , max_port_per_lacp_group (integer): , endpoint_support (boolean): , slow_response (boolean): , slow_response_start_time (string): , wlan_mac_list (array[wlan_mac_list]): , slot_module_list (array[slot_module]): List of slot module information, vlan_managed (boolean): (device detail) Indicates if the device has VLAN managed, icmg_mvpn (boolean): , icmg_wan (boolean): Indicates if Device WAN settings is managed by InControl, icmg_schedule_reboot (boolean): Indicates if the device is applying Device Schedule Reboot, icmg_schedule (boolean): Indicates if the device is applying Device Schedule, icmg_wlan (boolean): Indicates if SSID and Radio settings is managed by InControl, icmg_portal (boolean): Indicates if Captive Portal is managed by InControl, icmg_lan (boolean): Indicates if Device LAN IP settings is managed by InControl, icmg_sdswitch (boolean): , icmg_outbound (boolean): Indicates if Outbound Policy managed by InControl, icmg_firewall (boolean): Indicates if Firewall Rules is managed by InControl, icmg_admin (boolean): Indicates if device web admin management is managed by InControl, } tag_info { id (integer): Unique identifier of the device tag, name (string): Device tag name, } follow_loc_dev_info { id (integer): Unique identifier of the followed device, sn (string): S/N of the followed device, name (string): Device name of the followed device, onlineStatus (string): Online status of the followed device, } radio_module { module_id (integer): System generated Wi-Fi radio module identifier, frequency_band (string): Supported radio frequency bands, active_frequency_band (string): The active frequency band, } interface { id (integer): System generated interface identifier, type (string): Interface type, status (string): Interface status for InControl, Connected|Disconnected|Disabled|No SIM Card Detected|No Cable Detected, last_status (string): Wan status, Only exists if the device is offline, name (string): Interface name, ddns_host (string): DDNS host, ddns_name (string): Find My Peplink Address, ddns_enabled (boolean): Indicates if DDNS is enabled, dns_servers (array[string]): List of dns servers, ip_status (string): , conn_len (integer): , ip (string): IP, netmask (string): Netmask, is_enable (boolean): Indicates if the interface is enabled, conn_mode (integer): Routing mode, port_type (integer): Port type, gateway (string): Default gateway, mtu (number): MTU, healthcheck (string): Health check method, "nslookup" - DNS Lookup, "pstr" - SmartCheck, "disabled" - Disabled, "ping" - PING, "http" - HTTP, sims (interface_sims): SIMs info, meid_hex (string): MEID DEC, esn (string): ESN, imei (string): IMEI, imei_cdf (string): Cellular Module, apn (string): APN, username (string): Username for APN, password (string): Password for APN, dialnum (string): Dial Number for APN, carrier_name (string): Carrier, carrier_settings (string): Carrier settings, s2g3glte (string): Indicates if the network is "3G", "4G" or "LTE", signal_bar (integer): Indicates the signal bar level, -1: no signal, 0-5: signal bar level, gobi_data_tech (string): Network, gobi_band_class_name (string): Network band, gobi_band_2_class_name (string): Secondary band, cellular_signals (interface_cellular_signals): Cellular signals, gobi_band_2_cellular_signals (interface_cellular_signals): Cellular signals, cell_id (integer): Cell ID, adaptor_type (string): Modem adaptor type, vendor_id (integer): Modem adaptor vendor ID, product_id (integer): Modem adaptor product ID, modem_name (string): Modem adaptor name, modem_manufacturer (string): Modem adaptor manufacturer, status_led (string): Indicates the interface status in color in InControl, is_overall_up (integer): , standby_state (string): Standby state, connected|disconnect, mtu_state (integer): , healthy_state (integer): , connection_state (integer): Connection state, physical_state (integer): Physical state, is_backup (integer): , is_quota_exceed (integer): , is_manual_disconnect (integer): , conn_config_method (string): Connection Method, standby_mode (string): Standby mode, mtu_config (integer): MTU config, group (integer): Indicates the priority group id, updated_at (string): Interface info updated date and time, } interface_sims { imsi (string): IMSI, iccid (string): ICCID, status (string): SIM Status, active (boolean): Indicates if the SIM is active, bandwidthAllowanceMonitor (interface_sims_bandwdith_allowance_monitor): Bandwidth allowance monitor information of the WAN connection or SIM, } interface_sims_bandwdith_allowance_monitor { enable (boolean): Indicates if the bandwidth allowance monitor is enabled, } interface_cellular_signals { rssi (number): Signal Strength in RSSI (dBm), sinr (number): Signal Quality in SINR (dB), rsrp (number): Signal Strength in RSRP (dBm), rsrq (number): Signal Quality in RSRQ (dB), } vlan_interface { vlan_id (integer): VLAN ID, vlan_ip (string): VLAN IP, netmask (string): VLAN netmask, name (string): VLAN name, icmg (boolean): Indicates if the VLAN is managed by InControl, portal_id (integer): Unique identifier of VLAN portal, portal_name (string): Name of the VLAN portal, portal_enabled (boolean): Indicates if the VLAN portal is enabled, } ssid_profile { tags (array[tag_info]): Device tag selected, exempt_tags (array[tag_info]): Device tag exempted, fast_transition (boolean): Indicates if Fast Transition is enabled, acl_id (integer): Unique identifier of the Access Control List applied, access_control_list (access_control_list): Access Control List, device_select (string): Device Selection, portal_id (integer): Unique identifier of the applied captive portal, access_mode (array[string]): Access mode of the applied captive portal, id (integer): Unique identifier of the SSID profile, enabled (boolean): Indicates if the SSID profile is enabled, ssid (string): SSID, security (string): SSID security type, wep (wep_settings): WEP Security settings, layer2_isolation (boolean): Indicates if Layer 2 Isolation is enabled, mac_filter (string): MAC address filtering type, mac_list (array[string]): MAC Address List, multicast_filter (boolean): Indicates if multicast Filter is enabled, multicast_rate (string): Multicast Rate, broadcast (boolean): Indicates whether SSID is broadcasted, otherwise hidden, icMg (boolean): Indicates if the SSID profile is managed in InControl, vlan_id (integer): VLAN ID, radio_band (string): Radio Band(s) the SSID is available on, radio_select (string): Radio Band selected, 1 - 2.4ghz, 2 - 5ghz, 3 - both, band_steering (string): Band Steering, Default value: 'preferred', igmp_snooping (boolean): Indicates if IGMP snooping is enabled, portal_enabled (boolean): Indicates if captive portal is applied for the SSID profile, portal_url (string): , portal_cacheId (string): , portal_auth (string): , portal_cna_bypass (boolean): , portal_domain_accept (string): , portal_idle_sec (integer): , portal_inactive_timeout (integer): , portal_logout_kick (boolean): , radius_nasid_type (string): NAS-Identifier in RADUIS server settings, radius_nasid_custom (string): NAS-Identifier custom value in RADUIS server settings, bandwidth_control (boolean): , client_bandwidth_upstream (integer): Per client upstream limit in kbps (0: Unlimited) (Pepwave AP only), client_bandwidth_downstream (integer): Per client downstream limit in kbps (0: Unlimited) (Pepwave AP only), bandwidth_upstream (integer): Upstream limit in kbps (0: Unlimited) (Pepwave AP only), bandwidth_downstream (integer): Downstream limit in kbps (0: Unlimited) (Pepwave AP only), block_lan_access (boolean): Indicates if Block LAN Access is enabled (Pepwave AP only), block_custom_subnet (boolean): Indicates if Custom Subnet is applied, block_custom_subnet_list (string): Custom Subnet (Pepwave AP only), block_except (boolean): Indicates if Block Exception is applied, block_except_list (string): Block Exception (Pepwave AP only), block_mvpn (boolean): Indicates Block PepVPN is enabled, client_limit (integer): Maximum number of clients for 2.4 GHz, client_limit_5g (integer): Maximum number of clients for 5 GHz, qos (integer): Network Priority (QoS), 0 - Gold, 1 - Silver, 2 - Bronze, wpa_personal (wpa_personal_settings): WPA/WPA2 Security settings, schedule_id (integer): Device schedule, portal_custom (boolean): Indicates if external captive portal is applied for the SSID profile, radius_servers (array[radius_server]): List of RADIUS Server settings, } access_control_list { id (integer): Unique identifier of the access control list, group_id (integer): Unique identifier of the group, name (string): Name of the access control list, address (array[string]): List of MAC addresses, referenced_by (array[access_control_list_referenced_by]): List of access control list reference by object, Only appears when with_reference=true, } access_control_list_referenced_by { type (string): Type of reference object, id (integer): Unique identifier of the reference object, name (string): Name of the reference object, device_id (integer): Unique identifier of the device, group_id (integer): Unique identifier of the group, } wep_settings { key_format (string): Key Format, key_size (integer): Key size, encrypt_key (string): Encryption key., shared_key_auth (boolean): Indicates whether shared key authentication is enabled, } wpa_personal_settings { psk_enable (boolean): Indicates whether pre-shared key is enabled, shared_key (string): The pre-shared key, shared_key_type (string): Shared Key Option
"static" - Static shared key
"lan_mac" - Last 8 octets of LAN MAC address
"random" - Random, shared_key_random_prefix (string): required when shared_key_type=random, Prefix in generated shared key, shared_key_random_alphas (integer): required when shared_key_type=random, Number of alphabets generated in shared key, shared_key_random_digits (integer): required when shared_key_type=random, Number of digits generated in shared key, regenerate_shared_key (boolean): when update a SSID profile, Indicates if regenerate key is enabled, regenerate_shared_key_device_tags (array[integer]): when update a SSID profile, List of device tags IDs applied for the regenerate key, } radius_server { id (integer): RADIUS server identifier, host (string): Server host name, secret (string): Server secret, auth_port (integer): RADIUS server authentication port, account_port (integer): RADIUS server accounting port, radius_nasid_type (string): NAS-Identifier, Default: device_name, radius_nasid_custom (string): NAS-Identifier custom value, required when radius_nasid_type=custom, } ssid_profiles_applied { id (integer): System generated SSID profile identifier, ssid (string): SSID, group_id (integer): Unique identifier of the group, device_id (integer): Unique identifier of the device, portal_id (integer): Unique identifier of the captive portal/external captive portal, enabled (boolean): Indicates if the ssid profile is enabled, icMg (boolean): Indicates if the ssid profile is managed by InControl, vlan_id (integer): VLAN ID, portal_custom (boolean): Indicates if the portal is external captive portal, wpa_passphrase (string): WPA passphrase, the field would be hidden for read-only users, } radio_band { radio_bands (integer): Unique identifier of the radio band, active_band (string): The active frequency band, txpower (number): Output power, channel (integer): Channel, channel_mode (string): Channel Mode, } ssid_mac_list { bssid (string): BSSID of the ESSID, essid (string): ESSID, radio (string): Radio band, security (string): the security policy of the SSID, } periph_status { cpu_load (usage_data): CPU load, power_state (power_state): Power State, power_usage (usage_data): Power Usage, fan_speed (usage_data): Fan speed, thermal_sensor (temperature): Thermal Sensor, } usage_data { name (string): Name, value (number): Value, total (number): Total, voltage (number): Voltage, current (number): Current, percentage (number): Percentage, active (boolean): Active, } power_state { name (string): Name, connect (boolean): Indicates if the power is connected, } temperature { temperature (number): Temperature, max (number): Maximum, threshold (number): Threshold, min (number): Minimum, } port_status { } admin_conf { managed (boolean): Indicates if device web admin management is enabled, protocol (string): , admin_auth (string): , admin_user_auth (string): , version (integer): , admin_name (string): Admin User Name, admin_password (string): Admin password, admin_readonly_name (string): Read-only User Name, admin_readonly_password (string): Read-only User password, admin_radius_enable (boolean): Indicates if Authentication by RADIUS is enabled, } wlan_mac_list { bssid (string): BSSID of the ESSID, essid (string): ESSID, radio_band (string): Radio band, radio (string): Radio band, security (string): the security policy of the SSID, enabled (boolean): , encryption (string): , portal_id (integer): , } slot_module { slot (integer): Module slot, hw_ver (string): Module hardware version, sn (string): Module S/N, model (string): Module model, product_name (string): Module product name, expiry_date (string): Module expiry date and time, }
{ "resp_code": "", "caller_ref": "", "server_ref": "", "message": "", "data": { "client_id": "", "mac": "", "device": { "id": 0, "group_id": 0, "group_name": "", "sn": "", "name": "", "status": "", "usage": 0.0, "tx": 0.0, "rx": 0.0, "product_id": 0, "client_count": 0, "fw_ver": "", "last_online": "", "offline_at": "", "first_appear": "", "lan_mac": "", "config_rollback": true, "config_rollback_date": "", "ic2_config_apply_locked": true, "outstanding_patch_ids": [ "" ], "device_config_apply_locked": true, "sp_default": true, "product_name": "", "product_code": "", "mv": "", "tags": [ "" ], "tag_info": [ { "id": 0, "name": "" } ], "note": "", "longitude": 0.0, "latitude": 0.0, "address": "", "location_timestamp": "", "follow_loc_dev": 0, "follow_loc_dev_info": { "id": 0, "sn": "", "name": "", "onlineStatus": "" }, "isStatic": true, "expiry_date": "", "sub_expiry_date": "", "prime_expiry_date": "", "prime_type": 0, "expired": true, "sub_expired": true, "gps_support": true, "gps_exist": true, "support_ssid_count": 0.0, "radio_modules": [ { "module_id": 0, "frequency_band": "", "active_frequency_band": "" } ], "group_type": "", "device_type": "", "last_sync_date": "", "v6_license": "", "uptime": 0, "uptime_appear": "", "fw_pending_trial_round": 0, "fw_pending_max_no_of_trial": 0, "fw_pending_ver": "", "fw_pending_schedule_time": "", "fw_pending_upgrade_time": "", "fw_pending_status": 0, "fw_pending_group_time": "", "is_master_device": true, "fw_managmed": "", "wifi_cfg": "", "ddns_enabled": true, "ddns_available": true, "ddns_letsencrypt_enabled": true, "ddns_letsencrypt_cert_expiry_date": "", "ddns_letsencrypt_apply_date": "", "onlineStatus": "", "wtp_ip": "", "interfaces": [ { "id": 0, "type": "", "status": "", "last_status": "", "name": "", "ddns_host": "", "ddns_name": "", "ddns_enabled": true, "dns_servers": [ "" ], "ip_status": "", "conn_len": 0, "ip": "", "netmask": "", "is_enable": true, "conn_mode": 0, "port_type": 0, "gateway": "", "mtu": 0.0, "healthcheck": "", "sims": { "imsi": "", "iccid": "", "status": "", "active": true, "bandwidthAllowanceMonitor": { "enable": true } }, "meid_hex": "", "esn": "", "imei": "", "imei_cdf": "", "apn": "", "username": "", "password": "", "dialnum": "", "carrier_name": "", "carrier_settings": "", "s2g3glte": "", "signal_bar": 0, "gobi_data_tech": "", "gobi_band_class_name": "", "gobi_band_2_class_name": "", "cellular_signals": { "rssi": 0.0, "sinr": 0.0, "rsrp": 0.0, "rsrq": 0.0 }, "gobi_band_2_cellular_signals": { "rssi": 0.0, "sinr": 0.0, "rsrp": 0.0, "rsrq": 0.0 }, "cell_id": 0, "adaptor_type": "", "vendor_id": 0, "product_id": 0, "modem_name": "", "modem_manufacturer": "", "status_led": "", "is_overall_up": 0, "standby_state": "", "mtu_state": 0, "healthy_state": 0, "connection_state": 0, "physical_state": 0, "is_backup": 0, "is_quota_exceed": 0, "is_manual_disconnect": 0, "conn_config_method": "", "standby_mode": "", "mtu_config": 0, "group": 0, "updated_at": "" } ], "vlan_interfaces": [ { "vlan_id": 0, "vlan_ip": "", "netmask": "", "name": "", "icmg": true, "portal_id": 0, "portal_name": "", "portal_enabled": true } ], "ssid_profiles": [ { "tags": [ { "id": 0, "name": "" } ], "exempt_tags": [ { "id": 0, "name": "" } ], "fast_transition": true, "acl_id": 0, "access_control_list": { "id": 0, "group_id": 0, "name": "", "address": [ "" ], "referenced_by": [ { "type": "", "id": 0, "name": "", "device_id": 0, "group_id": 0 } ] }, "device_select": "", "portal_id": 0, "access_mode": [ "" ], "id": 0, "enabled": true, "ssid": "", "security": "", "wep": { "key_format": "", "key_size": 0, "encrypt_key": "", "shared_key_auth": true }, "layer2_isolation": true, "mac_filter": "", "mac_list": [ "" ], "multicast_filter": true, "multicast_rate": "", "broadcast": true, "icMg": true, "vlan_id": 0, "radio_band": "", "radio_select": "", "band_steering": "", "igmp_snooping": true, "portal_enabled": true, "portal_url": "", "portal_cacheId": "", "portal_auth": "", "portal_cna_bypass": true, "portal_domain_accept": "", "portal_idle_sec": 0, "portal_inactive_timeout": 0, "portal_logout_kick": true, "radius_nasid_type": "", "radius_nasid_custom": "", "bandwidth_control": true, "client_bandwidth_upstream": 0, "client_bandwidth_downstream": 0, "bandwidth_upstream": 0, "bandwidth_downstream": 0, "block_lan_access": true, "block_custom_subnet": true, "block_custom_subnet_list": "", "block_except": true, "block_except_list": "", "block_mvpn": true, "client_limit": 0, "client_limit_5g": 0, "qos": 0, "wpa_personal": { "psk_enable": true, "shared_key": "", "shared_key_type": "", "shared_key_random_prefix": "", "shared_key_random_alphas": 0, "shared_key_random_digits": 0, "regenerate_shared_key": true, "regenerate_shared_key_device_tags": [ 0 ] }, "schedule_id": 0, "portal_custom": true, "radius_servers": [ { "id": 0, "host": "", "secret": "", "auth_port": 0, "account_port": 0, "radius_nasid_type": "", "radius_nasid_custom": "" } ] } ], "ssid_profiles_applied": [ { "id": 0, "ssid": "", "group_id": 0, "device_id": 0, "portal_id": 0, "enabled": true, "icMg": true, "vlan_id": 0, "portal_custom": true, "wpa_passphrase": "" } ], "hardware_version": "", "mvpn_version": "", "radio_bands": [ { "radio_bands": 0, "active_band": "", "txpower": 0.0, "channel": 0, "channel_mode": "" } ], "loc_display": true, "extap_proxy_supported": true, "extap_proxy_enabled": true, "wlan_probe_supported": true, "wlan_probe_enabled": true, "dpi_supported": true, "dpi_enabled": true, "low_data_usage_mode": true, "ra_enabled": true, "watchdog_enabled": true, "ra_supported": true, "watchdog_supported": true, "ap_router_mode": true, "ssid_mac_list": [ { "bssid": "", "essid": "", "radio": "", "security": "" } ], "site_id": "", "handshake_port": true, "refuse_legacy": true, "peer_connections": 0, "pepvpn_peers": 0, "is_default_password": true, "is_apply_bulk_config": true, "is_wlan_ap_suspended": true, "is_ap_schedule_enabled": true, "is_ha_enabled": true, "is_ha_slave": true, "ha_role": "", "ha_status": "", "ha_transition_time": "", "periph_status_available": true, "periph_status": { "cpu_load": { "name": "", "value": 0.0, "total": 0.0, "voltage": 0.0, "current": 0.0, "percentage": 0.0, "active": true }, "power_state": { "name": "", "connect": true }, "power_usage": { "name": "", "value": 0.0, "total": 0.0, "voltage": 0.0, "current": 0.0, "percentage": 0.0, "active": true }, "fan_speed": { "name": "", "value": 0.0, "total": 0.0, "voltage": 0.0, "current": 0.0, "percentage": 0.0, "active": true }, "thermal_sensor": { "temperature": 0.0, "max": 0.0, "threshold": 0.0, "min": 0.0 } }, "port_status_available": true, "port_status": {}, "gobi_sim_lock_supported": true, "gobi_sim_locks": [ "" ], "poe_supported": true, "admin_conf": { "managed": true, "protocol": "", "admin_auth": "", "admin_user_auth": "", "version": 0, "admin_name": "", "admin_password": "", "admin_readonly_name": "", "admin_readonly_password": "", "admin_radius_enable": true }, "outbound_policy_managed": true, "firewall_rules_managed": true, "is_apply_import_lan": true, "is_apply_csv_override": true, "is_wlc_enabled": true, "mgnt_incontrol_vlan_ip": "", "mgnt_incontrol_vlan": 0, "mgnt_incontrol_vlan_gateway": "", "mgnt_incontrol_vlan_dns": [ "" ], "mgnt_incontrol_vlan_connection_type": "", "mgnt_vlan_ip": "", "mgnt_vlans": [ { "vlan_id": 0, "vlan_ip": "", "netmask": "", "name": "", "icmg": true, "portal_id": 0, "portal_name": "", "portal_enabled": true } ], "max_lacp_group_support": 0, "max_port_per_lacp_group": 0, "endpoint_support": true, "slow_response": true, "slow_response_start_time": "", "wlan_mac_list": [ { "bssid": "", "essid": "", "radio_band": "", "radio": "", "security": "", "enabled": true, "encryption": "", "portal_id": 0 } ], "slot_module_list": [ { "slot": 0, "hw_ver": "", "sn": "", "model": "", "product_name": "", "expiry_date": "" } ], "vlan_managed": true, "icmg_mvpn": true, "icmg_wan": true, "icmg_schedule_reboot": true, "icmg_schedule": true, "icmg_wlan": true, "icmg_portal": true, "icmg_lan": true, "icmg_sdswitch": true, "icmg_outbound": true, "icmg_firewall": true, "icmg_admin": true }, "duration": 0, "connection_type": "", "status": "", "ssid": "", "channel": 0, "ip": "", "channel_width": 0.0, "radio_mode": "", "signal": 0.0, "longitude": 0.0, "latitude": 0.0, "radius": 0.0, "last_seen": "" } }
Field | Type | Description |
---|---|---|
resp_code | string |
Response code
SUCCESS, INVALID_INPUT, INTERNAL_ERROR, PENDING |
caller_ref | string |
Caller reference identifier, auto generated if not specified
|
server_ref | string |
Server reference identifier, generated on server side
|
message | string |
Response message
|
data | client |
Response data object
|
Field | Type | Description |
---|---|---|
client_id | string |
Unique identifier of the client
|
mac | string |
MAC address
|
device | device |
The device the client currently attached to
|
duration | integer |
Wi-Fi connection duration in seconds
|
connection_type | string |
Connected via Wi-Fi or Ethernet
wireless, ethernet |
status | string |
Online status
active, inactive |
ssid | string |
SSID the client connected to
|
channel | integer |
Wi-Fi channel of the client connection
|
ip | string |
IP address
|
channel_width | number |
Wi-Fi channel width
|
radio_mode | string |
Wi-Fi radio mode
|
signal | number |
Signal strength
|
longitude | number |
Location longitude
|
latitude | number |
Location latitude
|
radius | number |
The distance from the longitude and latitude the client could locate
|
last_seen | string |
Last seen date and time of the client
|
Field | Type | Description |
---|---|---|
id | integer |
Unique identifier of the device
|
group_id | integer |
Unique identifier of the group
|
group_name | string |
Name of the group
|
sn | string |
Device S/N
|
name | string |
Device name
|
status | string |
Device status
online, offline |
usage | number |
Current bandwidth usage
|
tx | number |
Current upload usage
|
rx | number |
Current download usage
|
product_id | integer |
Unique identifier of the product
|
client_count | integer |
Current client count
|
fw_ver | string |
Firmware version using
|
last_online | string |
Last online date and time
|
offline_at | string |
Last offline date and time
|
first_appear | string |
First appeared date and time
|
lan_mac | string |
LAN MAC address
|
config_rollback | boolean |
Indicates if the recent change in outbound policy or firewall rules applied from InControl has been rolled back as the device was unable to reach InControl.
|
config_rollback_date | string |
Config roll back date and time
|
ic2_config_apply_locked | boolean |
Indicates if the device is "Config Locked" by InControl
|
outstanding_patch_ids | array[string] |
Unique identifier of the outstanding configuration patches
|
device_config_apply_locked | boolean |
Indicates if the device is "Config Locked" by device
|
sp_default | boolean |
Indicates if the active configuration is saved as SP default
|
product_name | string |
Product name
|
product_code | string |
Product code
|
mv | string |
Model variant
|
tags | array[string] |
List of Device tags name
|
tag_info | array[tag_info] |
List of Device tags information
|
note | string |
Note
|
longitude | number |
Location longitude
|
latitude | number |
Location latitude
|
address | string |
Location address
|
location_timestamp | string |
Location recorded time
|
follow_loc_dev | integer |
Device's ID of the followed location device
|
follow_loc_dev_info | follow_loc_dev_info |
Followed location device information
|
isStatic | boolean |
Indicates if the returned location is a static one
|
expiry_date | string |
Warranty expiry date
|
sub_expiry_date | string |
Subscription expiry date
|
prime_expiry_date | string |
Prime expiry date
|
prime_type | integer |
Prime Type: 1 - with prime subscription, 0 or undefined - without prime subscription
0, 1 |
expired | boolean |
Indicates if the device warranty has expired
|
sub_expired | boolean |
Indicates if the device subscription has expired
|
gps_support | boolean |
Indicates if the device support gps
|
gps_exist | boolean |
Indicates if the device with any gps records
|
support_ssid_count | number |
Supported number of SSIDs
|
radio_modules | array[radio_module] |
Supported radio modules
|
group_type | string |
Group type
peplink |
device_type | string |
Device type
|
last_sync_date | string |
Last config applied date and time
|
v6_license | string |
Indicates if the device has activated firmware 6.x license
enabled, disabled |
uptime | integer |
Device up time
|
uptime_appear | string |
Retrieval time of the device up time
|
fw_pending_trial_round | integer |
Firmware update trial count
|
fw_pending_max_no_of_trial | integer |
Maximum number of firmware update trial count
|
fw_pending_ver | string |
Version of the firmware to be updated
|
fw_pending_schedule_time | string |
Scheduled firmware update start time
|
fw_pending_upgrade_time | string |
Actual firmware update time
|
fw_pending_status | integer |
Firmware update status, 1 - active, 0 - inactive
0, 1 |
fw_pending_group_time | string |
Pending firmware update time in the group's time zone
|
is_master_device | boolean |
Indicates if the device is a master configuration cloning device
|
fw_managmed | string |
(only for device detail call) Indicates if the firmware is managed by organization level, group level or device level
|
wifi_cfg | string |
Indicates the device follows group or device level's SSID settings, or locally managed on the device
group, device, not_managed |
ddns_enabled | boolean |
Indicates if "Find My Peplink Service" enabled
|
ddns_available | boolean |
Indicates if "Find My Peplink Service" available
|
ddns_letsencrypt_enabled | boolean |
Indicates if "Manage Web Admin SSL Certificate" is enabled for "Find My Peplink Service"
|
ddns_letsencrypt_cert_expiry_date | string |
Web Admin SSL certificate expiry date and time
|
ddns_letsencrypt_apply_date | string |
Web Admin SSL certificate apply date and time
|
onlineStatus | string |
Current online status
|
wtp_ip | string |
Last Detected IP
|
interfaces | array[interface] |
Device interfaces
|
vlan_interfaces | array[vlan_interface] |
VLAN interfaces
|
ssid_profiles | array[ssid_profile] |
SSID profiles
|
ssid_profiles_applied | array[ssid_profiles_applied] |
Applied SSID profiles
|
hardware_version | string |
Hardware version
|
mvpn_version | string |
MVPN version
|
radio_bands | array[radio_band] |
Radio bands
|
loc_display | boolean |
Indicates if address displayed on "Location" field in InControl Device Detail Page: true - display address, false - display latitude/longitude
|
extap_proxy_supported | boolean |
Indicates if the device is a AP controller
|
extap_proxy_enabled | boolean |
Indicates if the device is a managed by AP controller
|
wlan_probe_supported | boolean |
Indicates if the device supports "Collecting Wi-Fi Analytics Data"
|
wlan_probe_enabled | boolean |
Indicates if the device enabled "Collecting Wi-Fi Analytics Data" in InControl
|
dpi_supported | boolean |
Indicates if the device supports deep packet inspection
|
dpi_enabled | boolean |
Indicates if the device enabled deep packet inspection
|
low_data_usage_mode | boolean |
Indicates if the device enabled low data usage mode
|
ra_enabled | boolean |
Indicates if the device enabled remote assistance
2.8.3 |
watchdog_enabled | boolean |
Indicates if the device enabled hardware watchdog
2.8.3 |
ra_supported | boolean |
Indicates if the device support remote assistance
2.8.3 |
watchdog_supported | boolean |
Indicates if the device support hardware watchdog
2.8.3 |
ap_router_mode | boolean |
Indicates if the device applied router mode, true - router mode, false - bridge mode
|
ssid_mac_list | array[ssid_mac_list] |
SSID mac list
|
site_id | string |
PepVPN Site ID
|
handshake_port | boolean |
(PepVPN / SpeedFusion) Handshake port
|
refuse_legacy | boolean |
(PepVPN / SpeedFusion) Indicates if the device accept connections from legacy firmware
|
peer_connections | integer |
PepVPN / SpeedFusion Peer Connections
|
pepvpn_peers | integer |
Maximum number of PepVPN / SpeedFusion Peer Connections
|
is_default_password | boolean |
Indicates if default password is used in device web admin
|
is_apply_bulk_config | boolean |
Indicates if the device is applied with bulk config
|
is_wlan_ap_suspended | boolean |
Indicates if the device WLAN AP is suspended
|
is_ap_schedule_enabled | boolean |
Indicates if the device AP schedule enabled
|
is_ha_enabled | boolean |
Indicates if high availability enabled
|
is_ha_slave | boolean |
Indicates if the device is a high availability slave unit
|
ha_role | string |
High Availability Preferred Role (master|slave)
|
ha_status | string |
High Availability Status
|
ha_transition_time | string |
Last Transition Date and time
|
periph_status_available | boolean |
Indicates if periph status is available
|
periph_status | periph_status |
Periph status
|
port_status_available | boolean |
Indicates if port status is available
|
port_status | port_status |
Port status
|
gobi_sim_lock_supported | boolean |
Indicates if the device support SIM lock
|
gobi_sim_locks | array[string] | |
poe_supported | boolean |
Indicates if the device support poe
|
admin_conf | admin_conf |
Admin configuration
|
outbound_policy_managed | boolean | |
firewall_rules_managed | boolean | |
is_apply_import_lan | boolean | |
is_apply_csv_override | boolean | |
is_wlc_enabled | boolean | |
mgnt_incontrol_vlan_ip | string | |
mgnt_incontrol_vlan | integer | |
mgnt_incontrol_vlan_gateway | string | |
mgnt_incontrol_vlan_dns | array[string] | |
mgnt_incontrol_vlan_connection_type | string | |
mgnt_vlan_ip | string | |
mgnt_vlans | array[vlan_interface] | |
max_lacp_group_support | integer | |
max_port_per_lacp_group | integer | |
endpoint_support | boolean | |
slow_response | boolean | |
slow_response_start_time | string | |
wlan_mac_list | array[wlan_mac_list] | |
slot_module_list | array[slot_module] |
List of slot module information
|
vlan_managed | boolean |
(device detail) Indicates if the device has VLAN managed
|
icmg_mvpn | boolean | |
icmg_wan | boolean |
Indicates if Device WAN settings is managed by InControl
|
icmg_schedule_reboot | boolean |
Indicates if the device is applying Device Schedule Reboot
|
icmg_schedule | boolean |
Indicates if the device is applying Device Schedule
|
icmg_wlan | boolean |
Indicates if SSID and Radio settings is managed by InControl
|
icmg_portal | boolean |
Indicates if Captive Portal is managed by InControl
|
icmg_lan | boolean |
Indicates if Device LAN IP settings is managed by InControl
|
icmg_sdswitch | boolean | |
icmg_outbound | boolean |
Indicates if Outbound Policy managed by InControl
|
icmg_firewall | boolean |
Indicates if Firewall Rules is managed by InControl
|
icmg_admin | boolean |
Indicates if device web admin management is managed by InControl
|
Field | Type | Description |
---|---|---|
id | integer |
Unique identifier of the device tag
|
name | string |
Device tag name
|
Field | Type | Description |
---|---|---|
id | integer |
Unique identifier of the followed device
|
sn | string |
S/N of the followed device
|
name | string |
Device name of the followed device
|
onlineStatus | string |
Online status of the followed device
|
Field | Type | Description |
---|---|---|
module_id | integer |
System generated Wi-Fi radio module identifier
|
frequency_band | string |
Supported radio frequency bands
|
active_frequency_band | string |
The active frequency band
|
Field | Type | Description |
---|---|---|
id | integer |
System generated interface identifier
|
type | string |
Interface type
|
status | string |
Interface status for InControl, Connected|Disconnected|Disabled|No SIM Card Detected|No Cable Detected
|
last_status | string |
Wan status, Only exists if the device is offline
|
name | string |
Interface name
|
ddns_host | string |
DDNS host
|
ddns_name | string |
Find My Peplink Address
|
ddns_enabled | boolean |
Indicates if DDNS is enabled
|
dns_servers | array[string] |
List of dns servers
|
ip_status | string | |
conn_len | integer | |
ip | string |
IP
|
netmask | string |
Netmask
|
is_enable | boolean |
Indicates if the interface is enabled
|
conn_mode | integer |
Routing mode
|
port_type | integer |
Port type
|
gateway | string |
Default gateway
|
mtu | number |
MTU
|
healthcheck | string |
Health check method, "nslookup" - DNS Lookup, "pstr" - SmartCheck, "disabled" - Disabled, "ping" - PING, "http" - HTTP
|
sims | interface_sims |
SIMs info
|
meid_hex | string |
MEID DEC
|
esn | string |
ESN
|
imei | string |
IMEI
|
imei_cdf | string |
Cellular Module
|
apn | string |
APN
|
username | string |
Username for APN
|
password | string |
Password for APN
|
dialnum | string |
Dial Number for APN
|
carrier_name | string |
Carrier
|
carrier_settings | string |
Carrier settings
|
s2g3glte | string |
Indicates if the network is "3G", "4G" or "LTE"
|
signal_bar | integer |
Indicates the signal bar level, -1: no signal, 0-5: signal bar level
|
gobi_data_tech | string |
Network
|
gobi_band_class_name | string |
Network band
|
gobi_band_2_class_name | string |
Secondary band
|
cellular_signals | interface_cellular_signals |
Cellular signals
|
gobi_band_2_cellular_signals | interface_cellular_signals |
Cellular signals
|
cell_id | integer |
Cell ID
|
adaptor_type | string |
Modem adaptor type
|
vendor_id | integer |
Modem adaptor vendor ID
|
product_id | integer |
Modem adaptor product ID
|
modem_name | string |
Modem adaptor name
|
modem_manufacturer | string |
Modem adaptor manufacturer
|
status_led | string |
Indicates the interface status in color in InControl
|
is_overall_up | integer | |
standby_state | string |
Standby state, connected|disconnect
|
mtu_state | integer | |
healthy_state | integer | |
connection_state | integer |
Connection state
|
physical_state | integer |
Physical state
|
is_backup | integer | |
is_quota_exceed | integer | |
is_manual_disconnect | integer | |
conn_config_method | string |
Connection Method
|
standby_mode | string |
Standby mode
|
mtu_config | integer |
MTU config
|
group | integer |
Indicates the priority group id
|
updated_at | string |
Interface info updated date and time
|
Field | Type | Description |
---|---|---|
imsi | string |
IMSI
|
iccid | string |
ICCID
|
status | string |
SIM Status
|
active | boolean |
Indicates if the SIM is active
|
bandwidthAllowanceMonitor | interface_sims_bandwdith_allowance_monitor |
Bandwidth allowance monitor information of the WAN connection or SIM
|
Field | Type | Description |
---|---|---|
enable | boolean |
Indicates if the bandwidth allowance monitor is enabled
|
Field | Type | Description |
---|---|---|
rssi | number |
Signal Strength in RSSI (dBm)
|
sinr | number |
Signal Quality in SINR (dB)
|
rsrp | number |
Signal Strength in RSRP (dBm)
|
rsrq | number |
Signal Quality in RSRQ (dB)
|
Field | Type | Description |
---|---|---|
vlan_id | integer |
VLAN ID
|
vlan_ip | string |
VLAN IP
|
netmask | string |
VLAN netmask
|
name | string |
VLAN name
|
icmg | boolean |
Indicates if the VLAN is managed by InControl
|
portal_id | integer |
Unique identifier of VLAN portal
|
portal_name | string |
Name of the VLAN portal
|
portal_enabled | boolean |
Indicates if the VLAN portal is enabled
|
Field | Type | Description |
---|---|---|
tags | array[tag_info] |
Device tag selected
|
exempt_tags | array[tag_info] |
Device tag exempted
|
fast_transition | boolean |
Indicates if Fast Transition is enabled
|
acl_id | integer |
Unique identifier of the Access Control List applied
|
access_control_list | access_control_list |
Access Control List
|
device_select | string |
Device Selection
disable, enable, exempt |
portal_id | integer |
Unique identifier of the applied captive portal
|
access_mode | array[string] |
Access mode of the applied captive portal
|
id | integer |
Unique identifier of the SSID profile
|
enabled | boolean |
Indicates if the SSID profile is enabled
|
ssid | string |
SSID
|
security | string |
SSID security type
open, wpa_wpa2_personal, wpa_wpa2_enterprise |
wep | wep_settings |
WEP Security settings
|
layer2_isolation | boolean |
Indicates if Layer 2 Isolation is enabled
|
mac_filter | string |
MAC address filtering type
none, deny, allow |
mac_list | array[string] |
MAC Address List
|
multicast_filter | boolean |
Indicates if multicast Filter is enabled
|
multicast_rate | string |
Multicast Rate
mcs0, mcs1, mcs2, mcs3, mcs4, mcs5, mcs6, mcs7 |
broadcast | boolean |
Indicates whether SSID is broadcasted, otherwise hidden
|
icMg | boolean |
Indicates if the SSID profile is managed in InControl
|
vlan_id | integer |
VLAN ID
|
radio_band | string |
Radio Band(s) the SSID is available on
2_4ghz, 5ghz, dual |
radio_select | string |
Radio Band selected, 1 - 2.4ghz, 2 - 5ghz, 3 - both
|
band_steering | string |
Band Steering, Default value: 'preferred'
disable, preferred, forced |
igmp_snooping | boolean |
Indicates if IGMP snooping is enabled
|
portal_enabled | boolean |
Indicates if captive portal is applied for the SSID profile
|
portal_url | string | |
portal_cacheId | string | |
portal_auth | string | |
portal_cna_bypass | boolean | |
portal_domain_accept | string | |
portal_idle_sec | integer | |
portal_inactive_timeout | integer | |
portal_logout_kick | boolean | |
radius_nasid_type | string |
NAS-Identifier in RADUIS server settings
device_name, lan_mac, sn, custom |
radius_nasid_custom | string |
NAS-Identifier custom value in RADUIS server settings
|
bandwidth_control | boolean | |
client_bandwidth_upstream | integer |
Per client upstream limit in kbps (0: Unlimited) (Pepwave AP only)
|
client_bandwidth_downstream | integer |
Per client downstream limit in kbps (0: Unlimited) (Pepwave AP only)
|
bandwidth_upstream | integer |
Upstream limit in kbps (0: Unlimited) (Pepwave AP only)
|
bandwidth_downstream | integer |
Downstream limit in kbps (0: Unlimited) (Pepwave AP only)
|
block_lan_access | boolean |
Indicates if Block LAN Access is enabled (Pepwave AP only)
|
block_custom_subnet | boolean |
Indicates if Custom Subnet is applied
|
block_custom_subnet_list | string |
Custom Subnet (Pepwave AP only)
|
block_except | boolean |
Indicates if Block Exception is applied
|
block_except_list | string |
Block Exception (Pepwave AP only)
|
block_mvpn | boolean |
Indicates Block PepVPN is enabled
|
client_limit | integer |
Maximum number of clients for 2.4 GHz
|
client_limit_5g | integer |
Maximum number of clients for 5 GHz
|
qos | integer |
Network Priority (QoS), 0 - Gold, 1 - Silver, 2 - Bronze
|
wpa_personal | wpa_personal_settings |
WPA/WPA2 Security settings
|
schedule_id | integer |
Device schedule
|
portal_custom | boolean |
Indicates if external captive portal is applied for the SSID profile
|
radius_servers | array[radius_server] |
List of RADIUS Server settings
|
Field | Type | Description |
---|---|---|
id | integer |
Unique identifier of the access control list
|
group_id | integer |
Unique identifier of the group
|
name | string |
Name of the access control list
|
address | array[string] |
List of MAC addresses
|
referenced_by | array[access_control_list_referenced_by] |
List of access control list reference by object, Only appears when with_reference=true
|
Field | Type | Description |
---|---|---|
type | string |
Type of reference object
firewall, outbound, ssid, portal, custom_portal |
id | integer |
Unique identifier of the reference object
|
name | string |
Name of the reference object
|
device_id | integer |
Unique identifier of the device
|
group_id | integer |
Unique identifier of the group
|
Field | Type | Description |
---|---|---|
key_format | string |
Key Format
ASCII, HEX |
key_size | integer |
Key size
|
encrypt_key | string |
Encryption key.
|
shared_key_auth | boolean |
Indicates whether shared key authentication is enabled
|
Field | Type | Description |
---|---|---|
psk_enable | boolean |
Indicates whether pre-shared key is enabled
|
shared_key | string |
The pre-shared key
|
shared_key_type | string |
Shared Key Option
"static" - Static shared key "lan_mac" - Last 8 octets of LAN MAC address "random" - Random static, lan_mac, random |
shared_key_random_prefix | string |
required when shared_key_type=random, Prefix in generated shared key
|
shared_key_random_alphas | integer |
required when shared_key_type=random, Number of alphabets generated in shared key
|
shared_key_random_digits | integer |
required when shared_key_type=random, Number of digits generated in shared key
|
regenerate_shared_key | boolean |
when update a SSID profile, Indicates if regenerate key is enabled
|
regenerate_shared_key_device_tags | array[integer] |
when update a SSID profile, List of device tags IDs applied for the regenerate key
|
Field | Type | Description |
---|---|---|
id | integer |
RADIUS server identifier
|
host | string |
Server host name
|
secret | string |
Server secret
|
auth_port | integer |
RADIUS server authentication port
|
account_port | integer |
RADIUS server accounting port
|
radius_nasid_type | string |
NAS-Identifier, Default: device_name
device_name, sn, lan_mac, custom |
radius_nasid_custom | string |
NAS-Identifier custom value, required when radius_nasid_type=custom
|
Field | Type | Description |
---|---|---|
id | integer |
System generated SSID profile identifier
|
ssid | string |
SSID
|
group_id | integer |
Unique identifier of the group
|
device_id | integer |
Unique identifier of the device
|
portal_id | integer |
Unique identifier of the captive portal/external captive portal
|
enabled | boolean |
Indicates if the ssid profile is enabled
|
icMg | boolean |
Indicates if the ssid profile is managed by InControl
|
vlan_id | integer |
VLAN ID
|
portal_custom | boolean |
Indicates if the portal is external captive portal
|
wpa_passphrase | string |
WPA passphrase, the field would be hidden for read-only users
|
Field | Type | Description |
---|---|---|
radio_bands | integer |
Unique identifier of the radio band
|
active_band | string |
The active frequency band
|
txpower | number |
Output power
|
channel | integer |
Channel
|
channel_mode | string |
Channel Mode
|
Field | Type | Description |
---|---|---|
bssid | string |
BSSID of the ESSID
|
essid | string |
ESSID
|
radio | string |
Radio band
|
security | string |
the security policy of the SSID
|
Field | Type | Description |
---|---|---|
cpu_load | usage_data |
CPU load
|
power_state | power_state |
Power State
|
power_usage | usage_data |
Power Usage
|
fan_speed | usage_data |
Fan speed
|
thermal_sensor | temperature |
Thermal Sensor
|
Field | Type | Description |
---|---|---|
name | string |
Name
|
value | number |
Value
|
total | number |
Total
|
voltage | number |
Voltage
|
current | number |
Current
|
percentage | number |
Percentage
|
active | boolean |
Active
|
Field | Type | Description |
---|---|---|
name | string |
Name
|
connect | boolean |
Indicates if the power is connected
|
Field | Type | Description |
---|---|---|
temperature | number |
Temperature
|
max | number |
Maximum
|
threshold | number |
Threshold
|
min | number |
Minimum
|
Field | Type | Description |
---|
Field | Type | Description |
---|---|---|
managed | boolean |
Indicates if device web admin management is enabled
|
protocol | string | |
admin_auth | string | |
admin_user_auth | string | |
version | integer | |
admin_name | string |
Admin User Name
|
admin_password | string |
Admin password
|
admin_readonly_name | string |
Read-only User Name
|
admin_readonly_password | string |
Read-only User password
|
admin_radius_enable | boolean |
Indicates if Authentication by RADIUS is enabled
|
Field | Type | Description |
---|---|---|
bssid | string |
BSSID of the ESSID
|
essid | string |
ESSID
|
radio_band | string |
Radio band
|
radio | string |
Radio band
|
security | string |
the security policy of the SSID
|
enabled | boolean | |
encryption | string | |
portal_id | integer |
Field | Type | Description |
---|---|---|
slot | integer |
Module slot
|
hw_ver | string |
Module hardware version
|
sn | string |
Module S/N
|
model | string |
Module model
|
product_name | string |
Module product name
|
expiry_date | string |
Module expiry date and time
|
Parameters
GET
/rest/o/{organization_id}/g/{group_id}/client/{client_id}/captive_portal_access_logs
Get captive portal access logs by client
Since:
Response Content Type:
Parameters
2.7.0
Response Content Type:
application/json
Parameters
GET
/rest/o/{organization_id}/g/{group_id}/client/{client_id}/captive_portal_user_info
Get captive portal user info by client
Since:
Response Content Type:
Model Schema
Model | Response Sample | Model Description
2.6.2
Response Content Type:
application/json
Model Schema
Model | Response Sample | Model Description
response { resp_code (string): Response code, caller_ref (string): Caller reference identifier, auto generated if not specified, server_ref (string): Server reference identifier, generated on server side, message (string): Response message, data (array[captive_portal_user_info]): Response data object, } captive_portal_user_info { access_mode (string): Captive portal access mode, social_network_user_id (string): User id collected in social mode, email (string): Email collected in e-mail or social mode, visit_count (number): No. of visit, first_login (string): First login date, in YYYY-MM-DD'T'HH:MM:SS format, last_login (string): Last login date, in YYYY-MM-DD'T'HH:MM:SS format, mobile_number (string): Mobile number collected in e-mail or SMS mode, first_name (string): First name collected in e-mail mode, last_name (string): Last name collected in e-mail mode, gender (string): Gender collected in e-