# Retrieves detailed information for all computers

Provides JSON objects containing detailed information for all computers, such as hostname, IP address, OS, status, remote office details, and more.

## Endpoints

`GET /dcapi/som/computersInfo`

## Request URL

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

## Scope

`DesktopCentralCloud.SOM.READ`

## Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Query Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `page` | integer | Optional | Specifies the page number to retrieve. Default is 1 |
| `size` | string | Optional | Specifies the maximum number of items to return per page. The default value is 25. A maximum of 1000 records can be retrieved in a single request |
| `domainName` | string | Optional | Returns computers that match the specified domain name. |
| `liveSyncStatus` | string | Optional | Returns computers based on their current live status. Supported values are: `up`: The system is working; `down`: The system is not working; `unknown`: The system status is not known. |
| `lastContactTime` | string | Optional | Returns computers that last contacted the server at the specified time in milliseconds. |
| `lastContactOperator` | string | Optional | Specifies the comparison operator used for filtering by last contact time. Supported values are: `gt` - Greater than; `ge` - Greater than or equal to; `lt` - Less than; `le` - Less than or equal to; `ne` - Not equal |
| `computerName` | string | Optional | Returns computers that matches the specified computer names. |
| `computerID` | string | Optional | Returns computers that matches the computerID |
| `agentVersion` | string | Optional | Returns computers that match the specified agent version number, such as 11.5.2614.01.W |
| `remoteOfficeID` | string | Optional | Returns computers that belong to the specified remote office ID. Use the `resource_id` field from the [Get Remote Offices](https://www.manageengine.com/products/desktop-central/help/api/cloud/remote-offices-get-remote-office.html) API response. |
| `customGroupID` | string | Optional | Returns computers that belong to the specified custom groups. Use the `group_id` field from the [Get Custom Groups](https://www.manageengine.com/products/desktop-central/help/api/cloud/custom-groups-get-cglist.html) API response. |
| `adOuGuid` | string | Optional | Returns computers that belong to the specified Active Directory organizational unit GUID. |
| `adOuName` | string | Optional | Returns computers that belong to the specified Active Directory organizational unit name. |
| `adOuDnName` | string | Optional | Returns computers that belong to the specified Active Directory organizational unit distinguished name. |
| `ipAddress` | string | Optional | Returns computers that match the specified IP address. |
| `isManaged` | string | Optional | Returns only managed computers when set to true. |
| `isServer` | string | Optional | Returns only server computers when set to true. |
| `isWorkstation` | string | Optional | Returns only workstation computers when set to true. |
| `serviceTag` | string | Optional | Returns computers that match the specified service tag. |
| `osPlatform` | string | Optional | Returns computers that match the specified operating system platform. Supported values are: `0` - Unknown; `1` - Windows; `2` - Mac; `3` - Linux |

## Sample Request

```curl
curl --request GET \
  --url https://appdomains/dcapi/som/computersInfo \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP Code 200

Response Body: `application/json`

`JSON Array`

- `JSON Object`

### Response Headers

| Header | Type | Description |
|---|---|---|
| `X-Total-Count` | string | Indicates the total number of computer records available |

## Possible Response Codes

| Code | Type | Description |
|---|---|---|
| `200` | HTTP code | Request processed successfully |

## Sample Response: HTTP 200

```json
[
  {
    "managedStatus": 61,
    "liveStatusUpdatedOn": "Feb 8, 2023 04:00 PM",
    "ownerEmailID": "--",
    "installationStatus": "Installed Successfully",
    "description": "--",
    "computerFullName": "JACK",
    "agentExecutedOn": "Feb 8, 2023 02:51 PM",
    "statusUpdatedOn": "Feb 8, 2023 02:51 PM",
    "osVersion": "10.0.19045",
    "computerName": "JACK",
    "lastContactTime": "Feb 8, 2023 02:50 PM",
    "osPlatform": "Windows",
    "agentUpgradedOn": "--",
    "liveStatus": "Live",
    "servicePack": "Windows 10 Version 2009 (x64)",
    "ipAddress": "11.33.3.42",
    "installationStatusCode": 22,
    "osName": "Windows 10 Professional Edition (x64)",
    "computerFQDNName": "JACK.EXAMPLE.MAIL.COM",
    "agentUninstalledOn": "--",
    "searchTag": "--",
    "computerId": "601",
    "macAddress": "00:29:0c:aa:00:01,6d:a2:zb:3a:a8:01",
    "computerGUID": "5mtu0yxygxzjliymy0yti4mti1zgi",
    "loggedUsers": "JACK",
    "distributionServerName": "JACK",
    "domainName": "WORKGROUP",
    "customerID": "1",
    "agentVersion": "10.1.2228.20.W",
    "supportedOperationinSDP": "Asset,Remote_Control,Tools",
    "agentInstalledOn": "Feb 8, 2023 01:21 PM",
    "location": "--",
    "remoteOfficeName": "ro1",
    "remoteOfficeID": "301",
    "remarks": "Agent Installed Successfully"
  },
  {
    "managedStatus": 62,
    "liveStatusUpdatedOn": "Feb 7, 2023 06:58 PM",
    "ownerEmailID": "--",
    "installationStatus": "Uninstalled Successfully",
    "description": "--",
    "computerFullName": "ROSE",
    "agentExecutedOn": "Feb 7, 2023 06:52 PM",
    "statusUpdatedOn": "Feb 7, 2023 06:52 PM",
    "osVersion": "10.0.19044",
    "computerName": "ROSE",
    "lastContactTime": "Feb 7, 2023 05:51 PM",
    "osPlatform": "Windows",
    "agentUpgradedOn": "--",
    "liveStatus": "Unknown",
    "servicePack": "Windows 10 Version 21H2 (x64)",
    "ipAddress": "10.51.241.7",
    "installationStatusCode": 23,
    "osName": "Windows 10 Professional Edition (x64)",
    "computerFQDNName": "ROSE.EXAMPLE.MAIL.COM",
    "agentUninstalledOn": "Feb 7, 2023 06:52 PM",
    "searchTag": "--",
    "computerId": "901",
    "macAddress": "0a:00:27:09:00:17,60:a2:89:a4:72:z7",
    "computerGUID": "3mtnjowu0mmi0mjzjmgi2nmqx",
    "loggedUsers": "ROSE-10549",
    "distributionServerName": "JACK",
    "domainName": "WORKGROUP",
    "customerID": "1",
    "agentVersion": "10.1.2228.20.W",
    "supportedOperationinSDP": "Asset",
    "agentInstalledOn": "Feb 6, 2023 10:25 AM",
    "location": "--",
    "remoteOfficeName": "ro1",
    "remoteOfficeID": "301",
    "remarks": "Agent UnInstalled Successfully"
  }
]
```

![ ](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**Duration:** 1 minute | **Threshold:** 30 | **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.