262-299-4606 • Email us

Inventory API

This page explains how to get your inventory extracted. Note that the example array of computers further down shows only the first computer and a subset of software installed for readability. You can use query parameters to filter your search.

Resources

/inventoryReturns your current inventoryGET
/inventory/{computername}Returns one computer's inventory by computer nameGET
Note that the prefix of urls above depend on which data center you belong to. Please log in to see the full url.

Headers

apikeyYour apikey listed in your settings to retrieve the dataint

Filters (query string parameters)

wantsoftwareUse this filter, if you wish to receive lists of installed software. The default is to not return installed softwarebit
  • Example filtered url to get 10 entries: /inventory?wantsoftware=1

Fields

nameThe computer's namestring
inventoryAvailableDetermines if inventory is collected for this computer. Privacy settings may disable inventory collection; see example two for non-inventoried computerbit
abrClientVersionInstalled version of the Admin By Request client software string
abrClientInstallDateInstall date of the Admin By Request client softwaredatetime
user.accountThe user account the end user used to log on to the computerstring
user.fullNameThe full name of the user userstring
user.emailThe user's email addressstring
user.phoneThe user's phone numberstring
user.domainThe user's Active Directory log on domain (if any)string
user.orgUnitName of user's Active Directory Organizational Unit (name of last node in the tree)string
user.orgUnitPathThe full path to the user's Active Directory Organizational Unitstring
user.groups[]The Active Directory or Azure AD groups the user is member ofstring
computer.domainThe computer's Active Directory domain (if any)string
computer.orgUnitName of computer's Active Directory Organizational Unit (name of last node in the tree)string
computer.orgUnitPathThe full path to the computer's Active Directory Organizational Unitstring
computer.groups[]The Active Directory or Azure AD groups the computer is member ofstring
computer.localAdmins[]List of local administratorsstring
computer.users[]List of user accounts on Mac computersstring
operatingSystem.platformOperating system platform (possible values: Windows, Mac, Server)string
operatingSystem.platformCode0 = Windows, 1 = Mac, 2 = Server, int
operatingSystem.nameName of operating system (e.g. Windows 10 Pro)string
operatingSystem.versionThe operating system versionint
operatingSystem.buildThe build number for Windows 10 or newerint
operatingSystem.buildUpdateThe update to the build version on Windows 10 or newerint
operatingSystem.typeWorkstation or Serverstring
operatingSystem.typeCode0 = Workstation, 1 = Serverint
operatingSystem.bitsOperating system bits (32 or 64)int
operatingSystem.installDateOperating system install datedatetime
hardware.makeThe vendor of the computerstring
hardware.modelThe model of the computerstring
hardware.typeDesktop or Portablestring
hardware.typeCode 0 = Portable/Laptop, 1 = Desktopint
hardware.serviceTagThe service tag (serial number) of the computerstring
hardware.cpuName and model of the CPUstring
hardware.cpuSpeedCPU speed in Mhzint
hardware.cpuCoresNumber of CPU coresint
hardware.diskSizeThe size of the primary disk in GBint
hardware.diskFreeFree disk space of the primary disk in GBint
hardware.diskStatusCurrent S.M.A.R.T. status of the primary diskstring
hardware.memoryAmount of memory in MBint
hardware.noMonitorsNumber of monitorsint
hardware.monitorResolutionResolution of the primary monitorstring
network.publicIPThe public IP address of the fastest active network adapterstring
network.privateIPThe private IP address of the fastest active network adapterstring
network.macAddressMAC address of the fastest active network adapterstring
network.nicSpeedSpeed (mbit) of the fastest active network adapterstring
network.hostNameThe public host name of the fastest active network adapterstring
location.cityThe city of the computer locationstring
location.regionThe region of the computer locationstring
location.countryThe country of the computer locationstring
location.latitudeThe latitude of the computer locationstring
location.longitudeThe longitude of the computer locationstring
location.googleMapsLinkThe location on Google Mapsstring
software[].applicationThe name of an application (description property of file)string
software[].vendorThe vendor of the applicationstring
software[].versionThe version of the applicationstring
software[].installDateThe install date of the applicationdatetime

Example successful request

[
  {
    "name": "W10405945",
    "inventoryAvailable": true,
    "abrClientVersion": "6.3.0",
    "abrClientInstallDate": "2020-03-27T08:15:32",
    "user": {
      "account": "PDH",
      "fullName": "Paul David Hewson",
      "email": "pdh@acme.com",
      "phone": "555.345.6789",
      "domain": "ACME",
      "orgUnit": "Users",
      "orgUnitPath": "\\Users",
      "groups": [
        "Domain Users",
        "Users"
      ]
    },
    "computer": {
      "domain": "ACME",
      "orgUnit": "Computers",
      "orgUnitPath": "\\Computers",
      "groups": [
        "Domain Computers"
      ],
      "localAdmins": [
        "Administrator",
        "ACME\\Domain Admins"
      ],
      "users": []
    },
    "operatingSystem": {
      "platform": "Windows",
      "platformCode": 0,
      "name": "Windows 10 Pro",
      "version": 1909,
      "build": 18363,
      "buildUpdate": 752,
      "type": "Workstation",
      "typeCode": 0,
      "bits": 64,
      "installDate": "2019-06-19T00:00:00"
    },
    "hardware": {
      "make": "Dell Inc.",
      "model": "XPS 9550",
      "type": "Laptop",
      "typeCode": 0,
      "serviceTag": "4577-7924-6610-3168-2590-1337-74",
      "cpu": "Intel Core i7-3520M CPU @ 2.90GHz",
      "cpuSpeed": 2893,
      "cpuCores": 4,
      "diskSize": 135,
      "diskFree": 84,
      "diskStatus": "OK",
      "memory": 2147,
      "noMonitors": 1,
      "monitorResolution": "1024x768"
    },
    "network": {
      "publicIP": "10.20.30.40",
      "privateIP": "10.10.129.52",
      "macAddress": "AF:4F:E3:23:62:E1",
      "nicSpeed": "1000 mbit",
      "hostName": "internal.acme.dk"
    },
    "location": {
      "city": "San Francisco",
      "region": "California",
      "country": "Unites States",
      "latitude": "37.7576948",
      "longitude": "122.4727052",
      "googleMapsLink": "https://maps.google.com/?q=37.7576948,122.4727052"
    },
    "software": [
      {
        "name": "Admin By Request Workstation",
        "version": "6.3.0.0",
        "vendor": "FastTrack Software",
        "installDate": "2020-03-27T00:00:00"
      },
      {
        "name": "Adobe Acrobat Reader DC",
        "version": "20.006.20042",
        "vendor": "Adobe Systems Incorporated",
        "installDate": "2020-04-01T00:00:00"
      },
      {
        "name": "Microsoft Office 365 ProPlus - en-us",
        "version": "16.0.11929.20648",
        "vendor": "Microsoft Corporation",
        "installDate": null
      },
      {
        "name": "Mozilla Firefox 67.0.1 (x86 en-US)",
        "version": "67.0.1",
        "vendor": "Mozilla",
        "installDate": null
      },
      {
        "name": "OPSWAT Client",
        "version": "7.6.271.0",
        "vendor": "OPSWAT, Inc.",
        "installDate": null
      },
      {
        "name": "Visual Studio Community 2019",
        "version": "16.4.29709.97",
        "vendor": "Microsoft Corporation",
        "installDate": "2020-01-19T00:00:00"
      }
    ]
  }
]


Example without inventory

[
  {
    "name": "W10405945",
    "inventoryAvailable": false,
    "abrClientVersion": "6.3.0",
    "abrClientInstallDate": "2020-03-27T08:15:32",
    "user": null,
    "computer": null,
    "operatingSystem": null,
    "hardware": null,
    "network": null,
    "location": null,
    "software": null
  }
]