Inventory Scan Computers


This API lists all the computers and their related scan details.

  • Functionality
  • Retrieve the inventory computers list.
  • HTTP Method 
  • GET
  • API URI
  • api/1.4/inventory/scancomputers
  • Auth Token Required
  • Yes
  • Paginated
  • Yes
  • Filters
  • domainfilter={String}:

    Get domain list from api/1.4/desktop/serverproperties

    branchofficefilter={String}:

    Get branch office list from api/1.4/desktop/serverproperties

    residfilter={Numeric}:

    Filter computer with particular resource id

    livestatusfilter={Numeric}:

    1    -    Live
    2    -    Down
    3    -    Unkown

    scanstatusfilter={Numeric}:

    21    -    Yet to install
    22    -    Installed
    23    -    uninstalled
    24    -    yet to uninstall
    29    -    installation failure

    installstatusfilter={Numeric}:


    -1   -    Not done
    0    -    failed
    1    -    In progress
    2    -    success
    installstatusfilter={Numeric}:


    -1   -    Not done
    0    -    failed
    1    -    In progress
  • Response Parameters
  • live_status:

    1    -    Live
    2    -    Down
    3    -    Unkown
    installation_status:

    21    -    Yet to install
    22    -    Installed
    23    -    uninstalled
    24    -    yet to uninstall
    29    -    installation failure

    scan_status :

    -1   -    Not done
    0    -    failed
    1    -    In progress
    2    -    success
     

Response Data

 
{ 
"message_response": { 
"total": 1,
 
"limit": 25,
 
"page": 1,
 
"scancomputers": [ 
{ 
"computer_live_status": 1,
 
"os_platform": 1,
 
"scan_remarks": "dc.common.SCANNING_COMPLETED",
 
"build_number": "7601",
 
"agent_installed_dir": "C:\Program Files (x86)\DesktopCentral_Agent\",
 
"scan_status": 2,
 
"agent_logged_on_users": "Administrator,admin",
 
"computer_status_update_time": 1450764296972,
 
"service_pack": "Service Pack 1",
 
"scan_remarks_en": "Scanning Completed",
 
"agent_last_contact_time": 1450417170806,
 
"process_start_time": 1450250502153,
 
"error_kb_url": "--",
 
"status_label": "dc.db.som.status.installed_successfully",
 
"branch_office_name": "Intern Ds Remote",
 
"last_sync_time": 1450767897942,
 
"process_end_time": 1450286646061,
 
"agent_installed_on": 1449570068627,
 
"os_version": "Windows 7 SP1 (x64)",
 
"last_successful_scan": 1450286646061,
 
"installation_status": 22,
 
"mac_address": "e8:9a:8f:3f:60:c8",
 
"resource_id": 313,
 
"domain_netbios_name": "DESKTOPCENTRAL",
 
"ip_address": "172.21.109.234",
 
"agent_version": "9.1.109.W",
 
"resource_name": "DC-W7-5",
 
"service_pack_minor_version": 0,
 
"software_name": "Windows 7 Professional Edition (x64)",
 
"service_pack_major_version": 1
 }
 ]
 },
 
"status": "success",
 
"message_version": "1.0",
 
"message_type": "scancomputers"
 }