# 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

| Parameter | Type | Required | Value |
|---|---|---|---|
| Accept | string | Mandatory | `application/computerInfo.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/cloud/computers-getcomputers.html) API. |

### Sample Request

#### Curl

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

| Parameter | Type | Description |
|---|---|---|
| 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`

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

### HTTP Code 404

Response Body: `application/json`

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

### HTTP Code 500

Response Body: `application/json`

| Parameter | Type | Description |
|---|---|---|
| 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.