Logo
Akamai APIs API Documentation

List client devices

GET https://{{host}}/etp-config/v3/configs/:configId/client/devices

Provides a list of client devices and its details.

 

Body PARAM

Key Datatype Required Description 
accountSwitchKey
string (Optional) For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys).



HEADERS

Key Datatype Required Description 
Accept
string




RESPONSES

status OK

[ { "blacklist": false, "id": "211edc0dfb5b4588b50df5f22246fddf", "mac": "02-00-4C-4F-4F-50", "name": "BOS-WP7XS", "originalId": "211edc0d-fb5b-4588-b50d-f5f22246fddf", "registeredTime": 1597350058, "reportedState": "PROTECTED", "reportedTime": 1597684417, "software": "Windows-3.2.0", "user": "jperez" }, { "blacklist": false, "id": "563b533d8c494bbaade7adcbdd6fba5c", "mac": "98-01-A7-BF-AA-31", "name": "MacBook-Air.local", "originalId": "563b533d-8c49-4bba-ade7-adcbdd6fba5c", "registeredTime": 1597460084, "reportedState": "NOT_PROTECTED_OTHER", "reportedTime": 1597684800, "software": "Mac-3.2.0", "user": "asingh" }, { "blacklist": false, "id": "630ace6b4f2641dfb411cd652512cb04", "mac": "38-C9-86-3D-D0-E2", "name": "Lab-Mac-19818179159.local", "originalId": "630ace6b-4f26-41df-b411-cd652512cb04", "registeredTime": 1593227576, "reportedState": "NOT_PROTECTED_OTHER", "reportedTime": 1597684260, "software": "Mac-3.1.1", "user": "hgildong" }, { "blacklist": false, "id": "6bff165ca84b41acb57056a79f49dc3f", "mac": "18-65-90-DA-CB-9B", "name": "Jacks-MacBook-Pro.local", "originalId": "6bff165c-a84b-41ac-b570-56a79f49dc3f", "registeredTime": 1597457344, "reportedState": "NOT_PROTECTED_OTHER", "reportedTime": 1597684799, "software": "Mac-3.2.0", "user": "jkowalski" }, { "blacklist": false, "id": "c0f06dc383774fcb92b41b7fb2f928e5", "mac": "00-0C-29-FD-77-4A", "name": "DESKTOP-6BDEKKS", "originalId": "c0f06dc3-8377-4fcb-92b4-1b7fb2f928e5", "registeredTime": 1597678280, "reportedState": "NOT_PROTECTED_OTHER", "reportedTime": 1597684542, "software": "Windows-3.2.0", "user": "jsmith" }, { "blacklist": false, "id": "dc475a9ec1924b0ba34ea95c0f8dfcad", "mac": "00-0C-29-D5-22-87", "name": "WIN81-ENT-210", "originalId": "dc475a9e-c192-4b0b-a34e-a95c0f8dfcad", "registeredTime": 1592853974, "reportedState": "PROTECTED", "reportedTime": 1597684516, "software": "Windows-3.1.1", "user": "jsmith" } ]



Curl
curl -X GET 'https://undefined/etp-config/v3/configs/:configId/client/devices?accountSwitchKey=' -H 'Accept: application/json'

ENDPOINTS