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

## Endpoint

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

## Request URL

`https://{serverurl}/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 --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 Limit

![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

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