# Retrieve complete hardware inventory of a computer

Returns the complete hardware inventory of a computer including all hardware components such as BIOS, processor, memory, disk, network adapter, and peripherals.

## Endpoints

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

## Request URL

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

## Scope

`DesktopCentralCloud.Inventory.READ`

## Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Accept** `string` — **Mandatory**
  - `application/hardwareInfo.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}/hardware \
  --header 'Accept: application/hardwareInfo.v1+json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP code 200

Response Body — `application/json`

`JSON Object`

- **processorDetails** `array`
  - Array of processor component details
- **diskDriveDetails** `array`
  - Array of disk drive component details
- **logicalDiskDetails** `array`
  - Array of logical disk details
- **motherBoardDetails** `array`
  - Array of motherboard details
- **biosDetails** `array`
  - Array of BIOS details
- **networkAdapterDetails** `array`
  - Array of network adapter details
- **videoControllerDetails** `array`
  - Array of video controller details
- **soundDeviceDetails** `array`
  - Array of sound device details
- **keyboardDetails** `array`
  - Array of keyboard details
- **pointingDeviceDetails** `array`
  - Array of pointing device details
- **printerDetails** `array`
  - Array of printer details
- **monitorDetails** `array`
  - Array of monitor details
- **usbControllerDetails** `array`
  - Array of USB controller details
- **usbHubDetails** `array`
  - Array of USB hub details
- **serialPortDetails** `array`
  - Array of serial port details
- **physicalMemorySlotDetails** `array`
  - Array of physical memory slot details
- **physicalMemoryDetails** `array`
  - Array of physical memory summary details
- **tpmDetails** `array`
  - Array of TPM details
- **batteryDetails** `array`
  - Array of battery details
- **cdromDetails** `array`
  - Array of CD-ROM details
- **modemDetails** `array`
  - Array of modem details
- **parallelPortDetails** `array`
  - Array of parallel port details
- **pcmciaDetails** `array`
  - Array of PCMCIA details
- **mappedLogicalDiskDetails** `array`
  - Array of mapped logical disk details

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

All hardware components (showing processorDetails and diskDriveDetails only)

```json
{
  "processorDetails": [
    {
      "hardwareDescription": "Sample Family",
      "hardwareStatusDescription": "Not Available",
      "hardwareDeviceID": "CPU0",
      "voltageCapability": "--",
      "hardwareType": "Processor",
      "hardwareInstalledComputerID": "301",
      "hardwareStatus": "OK",
      "processorVersion": "--",
      "hardwareDetectdTime": "May 14, 2026 03:02 PM",
      "numberOfLogicalProcessors": 12,
      "hardwareTypeID": 3,
      "hardwareManufacturerID": "2",
      "hardwareName": "Sample Processor @ 3.20GHz",
      "clockSpeed": 3192,
      "noOfCores": 6,
      "hardwareID": "2",
      "hardwareManufacturer": "SampleManufacturer",
      "processorFamily": "Sample Processor Family",
      "chipSocketDesignation": "U3E1"
    }
  ],
  "usbControllerDetails": [],
  "pcmciaDetails": [],
  "monitorDetails": [],
  "networkAdapterDetails": [],
  "biosDetails": [],
  "printerDetails": [],
  "cdromDetails": [],
  "batteryDetails": [],
  "physicalMemorySlotDetails": [],
  "soundDeviceDetails": [],
  "diskDriveDetails": [
    {
      "hardwareDescription": "Disk drive",
      "totalSizeInBytes": "954 GB",
      "hardwareStatusDescription": "Not Available",
      "serialNumber": "SAMPLE_SERIAL",
      "hardwareDeviceID": "\\\\.\\PHYSICALDRIVE0",
      "freeSizeInGB": 601,
      "freeSpaceInBytes": "645111586816",
      "hardwareType": "Disk Drive",
      "storageMedium": "Unspecified",
      "hardwareInstalledComputerID": "301",
      "hardwareStatus": "OK",
      "totalCylinders": 124519,
      "hardwareDetectdTime": "May 14, 2026 03:02 PM",
      "hardwareTypeID": 13,
      "totalSizeInGB": 954,
      "hardwareManufacturerID": "9",
      "diskDriveName": "Sample Disk 1024GB",
      "hardwareName": "Sample Disk 1024GB",
      "bytesPerSector": "512",
      "hardwareID": "12",
      "hardwareManufacturer": "(Standard disk drives)",
      "sectorPerTrack": "63"
    }
  ],
  "serialPortDetails": [],
  "videoControllerDetails": [],
  "logicalDiskDetails": [],
  "modemDetails": [],
  "keyboardDetails": [],
  "tpmDetails": [],
  "mappedLogicalDiskDetails": [],
  "parallelPortDetails": [],
  "motherBoardDetails": [],
  "physicalMemoryDetails": [],
  "pointingDeviceDetails": [],
  "usbHubDetails": []
}
```

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