# Get a consolidated inventory summary of a computer

Provides a consolidated summary of a computer by its ID. The response covers operating system details, software and hardware inventory, disk utilization, and general system information such as network, users, and license status.

## Endpoint

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

## Request URL

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

## Scope

`Inventory.READ`

## Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Accept** (`string`, Mandatory): `application/computerSummary.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/onpremise/computers-getcomputers.html) API.

## Sample Request

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

## Response Parameters

### HTTP Code 200

Response Body: `application/json`

`JSON Object`

- **osSummary** (`JSON Object`): Operating system details including OS name, version, service pack, build number, license type, and product ID.
- **assetSummary** (`JSON Object`): Asset counts including total software, hardware, prohibited software, commercial software, and missing patches.
- **diskUsageSummary** (`JSON Object`): Disk utilization including total size, used/free space in GB and percentages.
- **hardwareSummary** (`JSON Object`): Hardware summary including manufacturer, model, processor, RAM, warranty, and service tag.
- **generalSummary** (`JSON Object`): General system information including resource details, domain, network, scan status, logged-in user, and license status.

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

Full inventory summary of a computer

```json
{
  "osSummary": {
    "installedSystemDrive": "C:",
    "registeredTO": "SampleUser",
    "licenseType": "Retail",
    "osBuildNumber": "26200.8246",
    "osVersion": "10.0.26200",
    "productID": "00000-00000-00000-AA000",
    "osServicePack": "Windows 11 Version 25H2 (x64)",
    "osCDKey": "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX",
    "operatingSystem": "Windows 11 Professional Edition (x64)"
  },
  "hardwareSummary": {
    "computerType": "Desktop",
    "daysToWarrantyExpiry": "-579",
    "shippingDate": "Oct 10, 2019",
    "ramMemory": 16384,
    "manufacturerShortName": "Sample",
    "productNumber": "--",
    "computerManufacturer": "Sample Manufacturer",
    "warrantyExpiryDate": "Oct 11, 2024",
    "serviceTag": "SAMPLE01",
    "epochShippingDate": "1570714200000",
    "epochWarrantyExpiryDate": "1728653399000",
    "processorNames": "Sample Processor @ 3.20GHz",
    "computerAge": "6",
    "processorArchitecture": "x64-based PC",
    "redirectionURL": "https://www.example.com/support/servicetag/SAMPLE01",
    "computerModel": "Sample Model"
  },
  "generalSummary": {
    "resourceID": "301",
    "lastSyncTime": "May 14, 2026 06:03 PM",
    "isHPMachine": "No",
    "isWarrantyExpired": "Yes",
    "ipAddress": "10.0.0.1",
    "resourceName": "sample-computer",
    "lastSuccessfulScanTime": "May 14, 2026 03:02 PM",
    "macAddress": "00:00:00:00:00:00",
    "operatingSystemID": 1,
    "currentLoggedUser": "SampleUser",
    "licenseStatus": "Licensed",
    "domainName": "WORKGROUP",
    "customerID": "1",
    "lastBootTime": "Apr 30, 2026 01:20 PM",
    "isServerOS": "No",
    "isProxyDefined": "Yes",
    "osLanguage": "English",
    "isScanned": "Yes",
    "resourceType": 1
  },
  "assetSummary": {
    "totalHardwaresCount": 24,
    "totalSoftwaresCount": 35,
    "noncommercialSoftwaresCount": 0,
    "desktopAppsCount": 35,
    "missingPatchesCount": 0,
    "commercialSoftwaresCount": 0,
    "windowsStoreAppsCount": 0,
    "prohibitedSoftwaresCount": 0
  },
  "diskUsageSummary": {
    "diskFreePercentage": 63.06,
    "diskSize": 953,
    "diskUsedPercentage": 36.94,
    "diskUsedSize": 352,
    "diskFreeSize": 601
  }
}
```

## 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"
}
```

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