# Get general information of a computer

This API provides a high-level summary of a computer's general information, including customer and resource identifiers, domain, operating system details, network configuration, scan history, warranty status, and logged-in user information.

## Endpoint

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

## Request URL

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

## Scope

`Inventory.READ`

## Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Accept** (`string`, Mandatory): `application/computerInfo.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}/generalSummary \
  --header 'Accept: application/computerInfo.v1+json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP code 200

Response Body: `application/json`

JSON Object:

- **powerEventViewMsg** (`string`): Informational message about power event availability
- **customerID** (`string`): Customer identifier
- **isHPMachine** (`string`): Whether the machine is an HP device - Yes or No
- **showModernManagementInfo** (`string`): Whether to show modern management info - Yes or No
- **lastBootTime** (`string`): Last boot time in human-readable format
- **isClosedNetwork** (`string`): Whether the computer is in a closed network - Yes or No
- **resourceName** (`string`): Computer name
- **resourceID** (`string`): Unique resource identifier
- **isWarrantyExpired** (`string`): Whether warranty has expired - Yes or No
- **lastSuccessfulScanTime** (`string`): Last successful scan time in human-readable format
- **metroAppScanStatus** (`string`): Metro/Store app scan status code
- **resourceType** (`string`): Resource type identifier
- **domainName** (`string`): Domain or workgroup name
- **osLanguage** (`string`): Operating system language
- **macAddress** (`string`): Primary MAC address
- **isScanned** (`string`): Whether the computer has been scanned - Yes or No
- **isVMEnabled** (`string`): Whether virtualization is enabled - Yes or No
- **licenseStatus** (`string`): License status - Licensed or Unlicensed
- **isServerOS** (`string`): Whether the OS is a server OS - Yes or No
- **ipAddress** (`string`): Primary IP address
- **currentLoggedUser** (`string`): Currently logged-in user
- **primaryOwnerName** (`string`): Primary owner name
- **operatingSystemID** (`string`): Operating system identifier
- **lastSyncTime** (`string`): Last sync time in human-readable format
- **lastLoggedUser** (`string`): Last logged-in user
- **lastScanInitiatedTime** (`string`): Last scan initiated time
- **isProxyDefined** (`string`): Whether a proxy is defined - Yes or No

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

General summary of a computer

```json
{
  "lastSyncTime": "May 15, 2026 12:04 PM",
  "isClosedNetwork": "No",
  "lastScanInitiatedTime": "May 14, 2026 07:35 PM",
  "operatingSystemID": 1,
  "isServerOS": "No",
  "isProxyDefined": "Yes",
  "osLanguage": "English",
  "primaryOwnerName": "--",
  "resourceID": "301",
  "showModernManagementInfo": "No",
  "isHPMachine": "No",
  "isWarrantyExpired": "Yes",
  "ipAddress": "10.0.0.1",
  "metroAppScanStatus": 0,
  "resourceName": "sample-computer",
  "isVMEnabled": "No",
  "lastSuccessfulScanTime": "May 14, 2026 07:35 PM",
  "powerEventViewMsg": "This system was recently onboarded, and the power events that occurred after onboarding will only be available. The power events will be cleaned up 30 days after their occurrence.",
  "macAddress": "00:00:00:00:00:00",
  "currentLoggedUser": "SampleUser",
  "licenseStatus": "Licensed",
  "domainName": "WORKGROUP",
  "customerID": "1",
  "lastBootTime": "Apr 30, 2026 01:20 PM",
  "isScanned": "Yes",
  "resourceType": 1,
  "lastLoggedUser": "--"
}
```

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