Retrieve software installed on a computer

Open in ChatGPT Open in ChatGPT to ask questions about this page
Open in Claude Open in Claude to ask questions about this page
Copy as MarkdownCopy this page as markdown to use with AI assistants
View as Markdown Open this page as markdown in a new tab

This API retrieves the complete software information of a specific computer. It provides details such as software name, version, manufacturer, installation details, license usage, compliance status, architecture

Request URL

https://{server-hostname}:8383/dcapi/inventory/computers/{resourceID}/software

Scope

Inventory.READCopied!

Header

Authorization: d92d4xxxxxxxxxxxxx15f52

Request Parameters

- Request Headers

AcceptstringMandatory
application/softwareInfo.v1+jsonapplication/softwareInfo.v1+jsonCopied!

- Path Parameters

resourceIDstringMandatory

Resource identifier of the computer. Obtain from the response of the Get Computers List API.

Sample Request

Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request GET \
  --url https://appdomain/dcapi/inventory/computers/{resourceID}/software \
  --header 'Accept: application/softwareInfo.v1+json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'

Response Parameters

- HTTP code 200

Response Body - application/json
JSON Object
Hide Sub-Attributes
invswinstalled.app_installed_byinteger

Application installed by identifier

invswinstalled.uninstall_remarksstring

Uninstall remarks

invswtoosrel.app_identifierstring

Application identifier name

invswextn.architecturestring

Software architecture - 32-bit or 64-bit

invsw.commentsstring

Comments about the software

invmanagedsw.managed_sw_idinteger

Managed software ID

invswinstalled.installed_datestring

Installation date as epoch timestamp in milliseconds

invsw.software_idinteger

Unique software identifier

invmanagedsw.software_idinteger

Managed software reference ID

invswcategory.sw_category_namestring

Software category name

invswinstalled.installed_users_loginstring

User login under which software was installed

invswinstalledtouserrel.user_component_idstring

User component ID relation

invswinstalled.uninstall_statusstring

Uninstall status

invsw.detected_timestring

Detection time as epoch timestamp in milliseconds

invswlicenseusage.remaining_copiesstring

Remaining license copies

invswinstalledtouserrel.sw_installed_idstring

Software installed ID relation

invsw.software_versionstring

Software version

invsw.manufacturer_idinteger

Manufacturer identifier

invsw.installed_formatstring

Installed format - EXE or MSI

invswlicense.total_copiesstring

Total license copies

invsystemusers.namestring

System user name

invswlicense.license_ownerstring

License owner

invmanufacturer.manufacturer_namestring

Manufacturer name

invsw.sw_typeinteger

Software type identifier

invsystemusers.domainstring

System user domain

invsw.sw_familyinteger

Software family identifier

invswinstalled.locationstring

Installation location path

invswbinarysummary.binaries_countstring

Binaries count

invsw.is_usage_prohibitedinteger

Whether usage is prohibited - 0 or 1

invswlicenseusage.compliant_statusstring

Compliance status

invsw.software_namestring

Software display name

invswinstalled.component_idinteger

Component identifier

- HTTP code 401

Response Body - application/json
JSON Object
Hide Sub-Attributes
error_codestring

UAC_UNAUTHORIZED - user lacks the required uem-roles or credentials are missing

error_descriptionstring

Authentication or authorization failure reason

- HTTP code 404

Response Body - application/json
JSON Object
Hide Sub-Attributes
error_codestring

RESOURCE_NOT_AVAILABLE - the specified resourceID does not exist or is not accessible

error_descriptionstring

Resource not found message

- HTTP code 500

Response Body - application/json
JSON Object
Hide Sub-Attributes
error_codestring

INTERNAL_ERROR - unexpected exception in the service layer

error_descriptionstring

Internal server error message

Possible Response Codes

200HTTP code
401HTTP code
404HTTP code
500HTTP code

Sample Response: HTTP 200

Installed software list

Copied!
  [
    {
      "invswinstalled.app_installed_by": 0,
      "invswinstalled.uninstall_remarks": "--",
      "invswtoosrel.app_identifier": "Sample Software",
      "invswextn.architecture": "64-bit",
      "invsw.comments": "--",
      "invmanagedsw.managed_sw_id": 6,
      "invswinstalled.installed_date": "1778295232000",
      "invsw.software_id": 6,
      "invmanagedsw.software_id": 6,
      "invswcategory.sw_category_name": "--",
      "invswinstalled.installed_users_login": "-",
      "invswinstalledtouserrel.user_component_id": "--",
      "invswinstalled.uninstall_status": "--",
      "invsw.detected_time": "1778751155614",
      "invswlicenseusage.remaining_copies": "--",
      "invswinstalledtouserrel.sw_installed_id": "--",
      "invsw.software_version": "148.0.3967.54",
      "invsw.manufacturer_id": 14,
      "invsw.installed_format": "EXE",
      "invswlicense.total_copies": "--",
      "invsystemusers.name": "--",
      "invswlicense.license_owner": "--",
      "invmanufacturer.manufacturer_name": "Sample Manufacturer",
      "invsw.sw_type": 1,
      "invsystemusers.domain": "--",
      "invsw.sw_family": 1,
      "invswinstalled.location": "C:\\\\Program Files (x86)\\\\SampleApp\\\\Application",
      "invswbinarysummary.binaries_count": "--",
      "invsw.is_usage_prohibited": 0,
      "invswlicenseusage.compliant_status": "--",
      "invsw.software_name": "Sample Software",
      "invswinstalled.component_id": 39
    }
  ]
                
Show full

Sample Response: HTTP 401

Missing credentials

Copied!
  {
    "error_description": "Unauthorized access",
    "error_code": "UAC_UNAUTHORIZED"
  }
                
Show full

Sample Response: HTTP 404

Resource not found

Copied!
  {
    "error_description": "The specified resource was not found",
    "error_code": "RESOURCE_NOT_AVAILABLE"
  }
                
Show full

Sample Response: HTTP 500

Server error

Copied!
  {
    "error_description": "Internal server error",
    "error_code": "INTERNAL_ERROR"
  }
                
Show full

Duration: 1 minute | Threshold: 120 | Lock period: 5 minutes

Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.