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

## Endpoint

`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

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

- **X-Total-Count** `string`: Indicates the total number of computer records available

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