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

## Endpoints

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

## Request URL

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

## Scope

`DesktopCentralCloud.Inventory.READ`

## Header

`Authorization: Zoho-oauthtoken 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/cloud/computers-getcomputers.html) API.

## Sample Request

```curl
curl --request GET \
  --url https://appdomains/dcapi/inventory/computers/{resourceID}/generalSummary \
  --header 'Accept: application/computerInfo.v1+json' \
  --header 'Authorization: Zoho-oauthtoken  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"
}
```

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