# 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

### Request URL

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

### Scope

`Inventory.READ`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

| Parameter | Type | Required | Value |
|---|---|---|---|
| Accept | string | Mandatory | `application/softwareInfo.v1+json` |

#### Path Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| 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/onpremise/computers-getcomputers.html) API. |

### Sample Request

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

## Response

### HTTP 200

Response body: `application/json`

| Attribute | Type | Description |
|---|---|---|
| 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 |

#### Sample Response

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
  }
]
```

### HTTP 401

Response body: `application/json`

| Attribute | Type | Description |
|---|---|---|
| error_code | string | UAC_UNAUTHORIZED - user lacks the required uem-roles or credentials are missing |
| error_description | string | Authentication or authorization failure reason |

#### Sample Response

Missing credentials

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

### HTTP 404

Response body: `application/json`

| Attribute | Type | Description |
|---|---|---|
| error_code | string | RESOURCE_NOT_AVAILABLE - the specified resourceID does not exist or is not accessible |
| error_description | string | Resource not found message |

#### Sample Response

Resource not found

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

### HTTP 500

Response body: `application/json`

| Attribute | Type | Description |
|---|---|---|
| error_code | string | INTERNAL_ERROR - unexpected exception in the service layer |
| error_description | string | Internal server error message |

#### Sample Response

Server error

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

### Possible Response Codes

| HTTP Code |
|---|
| 200 |
| 401 |
| 404 |
| 500 |

## Rate Limits

![Help](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.