# Retrieves all computers details

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

## Endpoints

`GET /api/1.4/som/computers`

## Request URL

```text
https://{server-hostname}:8383/api/1.4/som/computers
```

## Scope

```text
Common.READ
```

## Header

```text
Authorization: d92d4xxxxxxxxxxxxx15f52
```

## Sample Request

```curl
curl --request GET \
  --url https://appdomain/api/1.4/som/computers \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP code 200

Response Body - application/json

- JSON Object
  - **message_type** (`string`): Name of the module
  - **message_response** (`JSON Object`): Response message containing computer details
  - **message_version** (`string`): Version of the Api
  - **status** (`string`): Status of the request

## Possible Response Codes

- **200** (`HTTP code`): Request processed successfully

## Sample Response: HTTP 200

```json
{
  "message_type": "computers",
  "message_response": {
    "total": 3,
    "limit": 25,
    "page": 1,
    "computers": [
      {
        "modernappdetails.remarks": "--",
        "remarks_args": "--",
        "agent_installed_on": 1756446785862,
        "agent_executed_on": 1756446785862,
        "processorarchtype.processor_arch_name": "x64-based PC",
        "os_platform_name": "Windows",
        "resource_id_string": "311",
        "service_pack": "Windows 11 Version 24H2 (x64)",
        "computer.processor_arch_type_id": 3,
        "computer.processor_architecture": 2,
        "os_platform": 1,
        "managedcomputer.previous_installation_status": -1,
        "agent_logged_on_users": "Alex",
        "resourcemacip.dhcp_server_ip_address": "10.92.2.20",
        "osflavor_id": 0,
        "search_tag": "--",
        "status_label": "dc.db.som.status.installed_successfully",
        "error_kb_url": "--",
        "full_name": "Alex",
        "owner_email_id": "--",
        "managedcomputertoerrcode.operation_type": 0,
        "agent_upgraded_on": -1,
        "installation_status": 22,
        "error_code": 0,
        "managedcomputer.agent_status": 0,
        "modernappdetails.enrollment_type": "--",
        "computer_status_update_time": 1756447132008,
        "managed_status": 61,
        "branch_office_name": "Local Office",
        "managedcomputer.re_installation_status": -1,
        "agent_last_contact_time": 1756463358000,
        "description": "--",
        "domain_netbios_name": "WORKGROUP",
        "fqdn_name": "ALEX.WORKGROUP.COM",
        "managedcomputer.agent_version_num": 114252201,
        "mac_address": "a0:ce:c8:b9:ae:15",
        "owner": "--",
        "modernappdetails.last_contact_time": 0,
        "managedcomputer.friendly_name": "a0:ce:c8:b9:ae:15 WORKGROUP 10.92.11.44",
        "resourcemacip.gateway_ip_address": "10.92.8.1",
        "resourcemacip.subnet_mask": "255.255.252.0",
        "os_version": "10.0.26100",
        "last_sync_time": 1756463913344,
        "modernappdetails.installed_at": 0,
        "ip_address": "10.92.11.44",
        "agent_uninstalled_on": -1,
        "agent_version": "11.4.2522.01.W",
        "resourcemacip.subnet_ip_address": "10.92.8.0",
        "agent_last_bootup_time": 1756275716000,
        "resource_id": 311,
        "os_name": "Windows 11 Professional Edition (x64)",
        "location": "--",
        "managedcomputer.friendly_name_type": 0,
        "computer_live_status": 1,
        "customer_name": "DC_CUSTOMER",
        "modernappdetails.status": "--",
        "resource_name": "Alex",
        "customer_id": 1,
        "remarks": "dc.db.agent.install.success"
      }
    ]
  },
  "message_version": "1.4",
  "status": "success"
}
```

## API Rate Limit

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