Device Summary


This API is for listing all the unique devices discovered in your network.

 

  • Functionality
  • To retrieve the list of devices detected within your network.
  • HTTP Method 
  • GET
  • API URI
  • api/1.4/reports/dcm/devicesummary
  • Filters
  • os_platform={Numeric}
    This is to filter based on OS Platform
    1 - Windows
    2 - Mac


    isblocked={Numeric}
    This is to filter devices based on allowed/blocked status
    0 - Allowed
    1 - Blocked


    devicetype={Numeric}
    This is to filter based on device type
    The code equivalents for each of the device types are as follows:
    2 - Biometric
    3 - Bluetooth
    4 - CDROM
    5 - DiskDrive
    9 - FloppyDisk
    19 - Image
    20 - Infrared
    21 - Keyboard
    24 - Modem
    26 - Mouse
    37 - Printer
    42 - SmartCardReader
    46 - TapeDrive
    49 - WPD
    100 - WPD_AppleDevices
    102 - SerialPorts(COM)
    103 - ParallelPorts(LPT)
    104 - WirelessNetworkAdapters
  • Paging
  • page={Numeric}
    This is for navigating to specific pages. This field denotes the current page.

    pagelimit={Numeric}
    This is to specify the number of records to be displayed per page.
  • Response Parameters
  • isblocked
    This denotes the last access status.
    0 - Allowed
    1 - Blocked
    usage_duration
    This denotes the duration of the last connection in milliseconds.

    All times are in epoch long format.

Response Data

 { 	"message_type": "dcm", 	"message_response": { 		"total": 2201, 		"limit": 25, 		"page": 1, 		"dcm": [ 			{ 				"custom_device_name": "--", 				"deviceaudit_id": 13861, 				"device_removed_time": 1744202349340, 				"managedcomputer.friendly_name": "5229799fva6j  0N70PQG", 				"vendor_hex_id": "046d", 				"os_platform": 1, 				"vendor_name": "Logitech, Inc.", 				"device_type": "smp.dcm.keyboard", 				"serial_number": "d0992e475_1726", 				"connected_count": 1, 				"userresource.name": "5229799fva6j-User", 				"product_name": "Unifying Receiver", 				"deviceauditevents.target_device_name": "Unifying Receiver", 				"is_blocked": 1, 				"product_hex_id": "c534", 				"last_occurrence": 1744116003923, 				"device_inserted_time": 1744116003923, 				"resource_name": "5229799fva6j", 				"usage_duration": 86345417, 				"computer_resource_id": 113341, 				"db_updated_time": 1744202454150, 				"deviceauditevents.target_manufacturer_name": "Microsoft" 			}, 			{ 				"custom_device_name": "--", 				"deviceaudit_id": 11241, 				"device_removed_time": 1744202320885, 				"managedcomputer.friendly_name": "2298099xp3Uq  TXJUW23", 				"vendor_hex_id": "0781", 				"os_platform": 1, 				"vendor_name": "SanDisk Corp.", 				"device_type": "smp.dcm.removablestoragedevice", 				"serial_number": "0401f1f4dca48f58a0c51ab643aa01b5f644bdb6e7be9d014bc0a70fdb27a3ea73a600000000000000000000204fbd83ff9f6418915581075ea8598650_1291", 				"connected_count": 1, 				"userresource.name": "2298099xp3Uq-User", 				"product_name": "Ultra Flair", 				"deviceauditevents.target_device_name": "Ultra Flair", 				"is_blocked": 0, 				"product_hex_id": "5591", 				"last_occurrence": 1744116003896, 				"device_inserted_time": 1744116003896, 				"resource_name": "2298099xp3Uq", 				"usage_duration": 86316989, 				"computer_resource_id": 113636, 				"db_updated_time": 1744202439034, 				"deviceauditevents.target_manufacturer_name": "Ultra" 			} 		] 	}, 	"message_version": "1.4", 	"status": "success", 	"response_code": 200 }