# 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

### Request URL

`https://{server-hostname}:8383/dcapi/som/computersInfo`

### Scope

`SOM.READ`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

### Sample Request

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

## Response Parameters

### HTTP code 200

Response Body - `application/json`

- JSON Array
  - JSON Object

### Possible Response Codes

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