Listing Licensed Software

Base URL

https://{SERVER}/api/?apikey={yourAPIkey}&service=list_licensed_software

Description

Lists licensed software for a specified asset.

Parameters

Required parameters

Add required parameters immediately after the base URL.

https://{SERVER}/api/?apikey={yourAPIkey}&service=list_licensed_software&required_parameters={parameter-value}

Parameter	Description	Type	Options	Default
assetid	The Id of the asset. The required assetid is referenced in the list_device_asset_details call.	integer	0	0

Parameter

Description

Type

Options

Default

assetid

The Id of the asset.

The required assetid is referenced in the list_device_asset_details call.

integer

Optional parameters

Add optional parameters after the required parameters in the base URL.

https://{SERVER}/api/?apikey={yourAPIkey}&service=list_licensed_software&required_parameters={parameter-value}&optional_parameters={parameter-value}

Parameter	Description	Type	Options	Default
describe	Optional. Returns a description of the entered call, the available parameters, an example of its output, and returned fields with descriptions.	boolean	true	0

Determine parameter values

Use the following associated service calls to determine parameter values.

Parameter	Call	URL Format
assetid	list_device_asset_details	https://{SERVER}/api/?apikey=yourAPIkey&service=list_device_asset_details&deviceid=DEVICEID
deviceid	list_devices_at_client	https://{SERVER}/api/?apikey=yourAPIkey&service=list_devices_at_client&clientid=CLIENTID&devicetype=server
	list_servers	https://{SERVER}/api/?apikey=yourAPIkey&service=list_servers&siteid=SITEID
	list_workstations	https://{SERVER}/api/?apikey=yourAPIkey&service=list_workstations&siteid=SITEID
siteid	list_sites	https://{SERVER}/api/?apikey=yourAPIkey&service=list_sites&clientid=CLIENTID
clientid	list_clients	https://{SERVER}/api/?apikey=yourAPIkey&service=list_clients

Examples

List Licensed Software

https://{SERVER}/api/?apikey={yourAPIkey}&service=list_licensed_software&assetid=ASSETID

Example response

<?xml version="1.0"?>
<result created="2024-10-01T15:29:38+01:00" host="SERVER" status="OK">
  <items>
    <licensed_software>
      <softwareid>3710969</softwareid>
      <catalogid>193</catalogid>
      <name>Advanced Monitoring Agent</name>
      <version />
      <install_date />
    </licensed_software>
    <licensed_software>
      <softwareid>3710863</softwareid>
      <catalogid>44185</catalogid>
      <name>Adobe Reader 7.1.0</name>
      <version>7.1.0</version>
      <install_date>2008-09-04 00:00:00</install_date>
    </licensed_software>
    <!-- more <licensed_software> nodes -->
  </items>
</result>

Returned fields

Field	Type	Can Be Empty	Description
softwareid	integer	no	The unique identifier of the software on this asset.
catalogid	integer	no	The unique identifier of the software.
name	string	yes	The name of the software.
version	string	yes	The version of the software installed on this asset.
install_date	datetime	no	The date and time the software was installed.