# Retrieve operating system details of a computer

Returns the operating system information of a computer including OS name, version, service pack, architecture, and installation date.

## Endpoints

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

## Request URL

`https://{serverurl}/dcapi/inventory/computers/{resourceID}/osInformation`

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

## Scope

`DesktopCentralCloud.Inventory.READ`

## Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

| Parameter | Type | Required | Value |
|---|---|---|---|
| Accept | string | Mandatory | `application/osInformation.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 --request GET \
  --url https://appdomains/dcapi/inventory/computers/{resourceID}/osInformation \
  --header 'Accept: application/osInformation.v1+json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP Code 200

Response Body: `application/json`

| Parameter | Type | Description |
|---|---|---|
| operatingSystem | string | Operating system name with architecture |
| installedSystemDrive | string | System drive letter where OS is installed |
| registeredTO | string | Name the OS is registered to |
| osVersion | string | OS version string |
| osServicePack | string | OS service pack or version name |
| osBuildNumber | string | OS build number |
| productID | string | OS product ID |
| licenseType | string | License type - Retail, OEM, Volume, etc. |
| osCDKey | string | OS product key |

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

OS details

```json
{
  "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)"
}
```

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

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