# Retrieve software installed on a computer

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.

## Endpoints

**GET** `/dcapi/inventory/computers/{resourceID}/software`

## Request URL

`https://[{serverurl}](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)/dcapi/inventory/computers/{resourceID}/software`

## Scope

`DesktopCentralCloud.Inventory.READ`

### Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Accept** `string` — **Mandatory**  
  `application/softwareInfo.v1+json`

### Path Parameters

- **resourceID** `string` — **Mandatory**  
  Resource identifier of the computer. Obtain from the response of the [Get Computers List](https://www.manageengine.com/products/desktop-central/help/api/cloud/computers-getcomputers.html) API.

### Query Parameters

- **licensetypefilter** `integer` — Optional  
  1 - Commercial, 2 - Non-commercial, 0 - Unidentified

- **accesstypefilter** `integer` — Optional  
  1 - Allowed, 2 - Prohibited, 0 - Not assigned

- **compliancestatusfilter** `integer` — Optional  
  0 - Under licensed, 1 - Over licensed, 2 - In compliance, 3 - Expired, -1 - Not available

- **oscompatibilityfilter** `string` — Optional  
  32-bit, 64-bit, or Neutral

## Sample Request

### Curl

```curl
curl --request GET \
  --url https://appdomains/dcapi/inventory/computers/{resourceID}/software \
  --header 'Accept: application/softwareInfo.v1+json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP code 200

#### Response Body — application/json

`JSON Object`

- **invswinstalled.app_installed_by** `integer`  
  Application installed by identifier

- **invswinstalled.uninstall_remarks** `string`  
  Uninstall remarks

- **invswtoosrel.app_identifier** `string`  
  Application identifier name

- **invswextn.architecture** `string`  
  Software architecture - 32-bit or 64-bit

- **invsw.comments** `string`  
  Comments about the software

- **invmanagedsw.managed_sw_id** `integer`  
  Managed software ID

- **invswinstalled.installed_date** `string`  
  Installation date as epoch timestamp in milliseconds

- **invsw.software_id** `integer`  
  Unique software identifier

- **invmanagedsw.software_id** `integer`  
  Managed software reference ID

- **invswcategory.sw_category_name** `string`  
  Software category name

- **invswinstalled.installed_users_login** `string`  
  User login under which software was installed

- **invswinstalledtouserrel.user_component_id** `string`  
  User component ID relation

- **invswinstalled.uninstall_status** `string`  
  Uninstall status

- **invsw.detected_time** `string`  
  Detection time as epoch timestamp in milliseconds

- **invswlicenseusage.remaining_copies** `string`  
  Remaining license copies

- **invswinstalledtouserrel.sw_installed_id** `string`  
  Software installed ID relation

- **invsw.software_version** `string`  
  Software version

- **invsw.manufacturer_id** `integer`  
  Manufacturer identifier

- **invsw.installed_format** `string`  
  Installed format - EXE or MSI

- **invswlicense.total_copies** `string`  
  Total license copies

- **invsystemusers.name** `string`  
  System user name

- **invswlicense.license_owner** `string`  
  License owner

- **invmanufacturer.manufacturer_name** `string`  
  Manufacturer name

- **invsw.sw_type** `integer`  
  Software type identifier

- **invsystemusers.domain** `string`  
  System user domain

- **invsw.sw_family** `integer`  
  Software family identifier

- **invswinstalled.location** `string`  
  Installation location path

- **invswbinarysummary.binaries_count** `string`  
  Binaries count

- **invsw.is_usage_prohibited** `integer`  
  Whether usage is prohibited - 0 or 1

- **invswlicenseusage.compliant_status** `string`  
  Compliance status

- **invsw.software_name** `string`  
  Software display name

- **invswinstalled.component_id** `integer`  
  Component identifier

### HTTP code 401

#### Response Body — application/json

`JSON Object`

- **error_code** `string`  
  UAC_UNAUTHORIZED - user lacks the required uem-roles or credentials are missing

- **error_description** `string`  
  Authentication or authorization failure reason

### HTTP code 404

#### Response Body — application/json

`JSON Object`

- **error_code** `string`  
  RESOURCE_NOT_AVAILABLE - the specified resourceID does not exist or is not accessible

- **error_description** `string`  
  Resource not found message

### HTTP code 500

#### Response Body — application/json

`JSON Object`

- **error_code** `string`  
  INTERNAL_ERROR - unexpected exception in the service layer

- **error_description** `string`  
  Internal server error message

## Possible Response Codes

- **200** — HTTP code
- **401** — HTTP code
- **404** — HTTP code
- **500** — HTTP code

## Sample Response: HTTP 200

Installed software list

```json
[
  {
    "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
  }
]
```

## Sample Response: HTTP 401

Missing credentials

```json
{
  "error_description": "Unauthorized access",
  "error_code": "UAC_UNAUTHORIZED"
}
```

## Sample Response: HTTP 404

Resource not found

```json
{
  "error_description": "The specified resource was not found",
  "error_code": "RESOURCE_NOT_AVAILABLE"
}
```

## Sample Response: HTTP 500

Server error

```json
{
  "error_description": "Internal server error",
  "error_code": "INTERNAL_ERROR"
}
```

## Rate Limits

**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.