List a specific device

Retrieve a specific device (server object) for the authenticated user.

SecuritybearerAuth
Request
path Parameters
id
required
integer

Server ID for the specified device.

query Parameters
o
required
integer

Organization ID for the specified device.

PS_VERSION
integer

The version of PowerShell running on the device.

include_details
integer
Default: 0

Include device details in response. Format: include_details=1 See Automox API Documentation - Servers API - Fast by Default

Enum: 0 1
include_server_events
integer
Default: 0

Include server events (reboot_deferral_count and patch_deferral_count) in response. Format: include_server_events=1. See Automox API Documentation - Servers API - Fast by Default

Enum: 0 1
include_next_patch_time
integer
Default: 0

Include the next patch time in response. Format: include_next_patch_time=1. See Automox API Documentation - Servers API - Fast by Default

Enum: 0 1
exclude_policy_status
integer
Default: 0

Exclude the policy status in response. Format: exclude_policy_status=1. See Automox API Documentation - Servers API - Fast by Default

Enum: 0 1
Responses
200

successful operation

400

Invalid Request

401

Access token is missing or invalid

403

You do not have permission to perform this action.

404

Entity not found

429

Too many requests

503

Service Unavailable

default

Invalid Request

get/servers/{id}
Request samples
$apiKey = 'your_automox_api_key'
$headers = @{ "Authorization" = "Bearer $apiKey" }
$url = "https://console.automox.com/api/servers/123456?o=0000"
$response = (Invoke-WebRequest -Method Get -Uri $url -Headers $headers).Content
Response samples
application/json
[
  • {
    • "id": 123456,
    • "agent_version": "1.45.48",
    • "commands": [ ],
    • "compatibility_checks": {
      • "low_diskspace": false,
      • "missing_wmi_integrity_check": false,
      • "missing_powershell": false
      },
    • "compliant": false,
    • "connected": false,
    • "create_time": "2024-12-19T17:42:48+0000",
    • "custom_name": "",
    • "deleted": false,
    • "detail": {
      • "VERSION": "LNVNB161216",
      • "VENDOR": "LENOVO",
      • "LAST_USER_LOGON": {
        • "SRC": "TEST",
        • "USER": "TEST\\john.doe",
        • "TIME": "12/25/2024 8:34:32 AM"
        },
      • "MODEL": "82R9",
      • "IPS": [
        • "192.168.8.135",
        • "bcb6:a517:7ac1:7c98:0b51:bcd3:1183:82a8",
        • "3399:59b4:f568:cada:76b6:ee0c:7a0e:7a75",
        • "41c0:fdce:d075:df45:35b2:c995:7caa:73b8",
        • "44ea:9f49:34e0:ddb6:ec1c:a368:b398:4f03",
        • "c5e8:d9d2:91fb:7a69:843b:d575:7dc4:2f44"
        ],
      • "WSUS_CONFIG": {
        • "WSUS_REACHABLE": "0",
        • "WSUS_MANAGED": "0",
        • "WSUS_SERVER": ""
        },
      • "MDM_PROFILE_INSTALLED": null,
      • "RAM": "17179869184",
      • "CPU": "AMD Ryzen 5 5500U with Radeon Graphics ",
      • "MDM_SERVER": null,
      • "FQDNS": [
        • "TEST.WORKGROUP"
        ],
      • "NICS": [
        • {
          • "CONNECTED": true,
          • "VENDOR": "MediaTek Wi-Fi 6 MT7921 Wireless LAN Card",
          • "DEVICE": "Wi-Fi",
          • "TYPE": "enet",
          • "MAC": "e9:4f:2b:90:a0:5c",
          • "IPS": [
            • "192.168.8.135",
            • "bcb6:a517:7ac1:7c98:0b51:bcd3:1183:82a8",
            • "3399:59b4:f568:cada:76b6:ee0c:7a0e:7a75",
            • "41c0:fdce:d075:df45:35b2:c995:7caa:73b8",
            • "44ea:9f49:34e0:ddb6:ec1c:a368:b398:4f03",
            • "c5e8:d9d2:91fb:7a69:843b:d575:7dc4:2f44"
            ]
          },
        • {
          • "TYPE": "enet",
          • "MAC": "e9:4f:2b:90:a0:5d",
          • "IPS": [ ],
          • "CONNECTED": false,
          • "VENDOR": "Bluetooth Device (Personal Area Network)",
          • "DEVICE": "Bluetooth Network Connection"
          },
        • {
          • "CONNECTED": false,
          • "VENDOR": "Microsoft Wi-Fi Direct Virtual Adapter",
          • "DEVICE": "",
          • "TYPE": "enet",
          • "MAC": "c3:1d:1d:e9:94:ef",
          • "IPS": [ ]
          },
        • {
          • "MAC": "c3:1d:1d:e9:a4:ff",
          • "IPS": [ ],
          • "CONNECTED": false,
          • "VENDOR": "Microsoft Wi-Fi Direct Virtual Adapter",
          • "DEVICE": "",
          • "TYPE": "enet"
          },
        • {
          • "CONNECTED": false,
          • "VENDOR": "WAN Miniport (IP)",
          • "DEVICE": "",
          • "TYPE": "enet",
          • "MAC": "4a:37:21:70:2e:f0",
          • "IPS": [ ]
          },
        • {
          • "IPS": [ ],
          • "CONNECTED": false,
          • "VENDOR": "WAN Miniport (IPv6)",
          • "DEVICE": "",
          • "TYPE": "enet",
          • "MAC": "bf:b5:ab:21:b8:63"
          },
        • {
          • "MAC": "cf:b6:ab:21:b8:63",
          • "IPS": [ ],
          • "CONNECTED": false,
          • "VENDOR": "WAN Miniport (Network Monitor)",
          • "DEVICE": "",
          • "TYPE": "enet"
          }
        ],
      • "WMI_INTEGRITY_CHECK": "True",
      • "SECURE_TOKEN_ACCOUNT": null,
      • "VOLUME": [
        • {
          • "FSTYPE": "NTFS",
          • "LABEL": "Windows-SSD",
          • "AVAIL": "509722226688",
          • "FREE": "408418480128",
          • "IS_SYSTEM_DISK": "True",
          • "VOLUME": "C:"
          }
        ],
      • "PS_VERSION": "5.1.26100.2161",
      • "UPDATE_SOURCE_CHECK": {
        • "CONNECTED": "True",
        • "ERROR": "Succeeded"
        },
      • "SERVICETAG": "No Asset Tag",
      • "SERIAL": "AB123ZX",
      • "DISKS": [
        • {
          • "TYPE": "Micron MTFDKCD512TFK",
          • "SIZE": "512105932800"
          }
        ],
      • "DISTINGUISHED_NAME": "",
      • "AUTO_UPDATE_OPTIONS": {
        • "OPTIONS": "off",
        • "ENABLED": "1"
        }
      },
    • "display_name": "TEST",
    • "exception": false,
    • "instance_id": "",
    • "ip_addrs": [
      • "123.45.67.210"
      ],
    • "ip_addrs_private": [
      • "192.168.8.135",
      • "bcb6:a517:7ac1:7c98:0b51:bcd3:1183:82a8",
      • "3399:59b4:f568:cada:76b6:ee0c:7a0e:7a75",
      • "41c0:fdce:d075:df45:35b2:c995:7caa:73b8",
      • "44ea:9f49:34e0:ddb6:ec1c:a368:b398:4f03",
      • "c5e8:d9d2:91fb:7a69:843b:d575:7dc4:2f44"
      ],
    • "is_compatible": true,
    • "is_delayed_by_notification": false,
    • "is_delayed_by_user": true,
    • "last_disconnect_time": "2025-01-22T22:18:21+0000",
    • "last_logged_in_user": "TEST\\john.doe",
    • "last_process_time": "2025-01-22T22:02:14+0000",
    • "last_refresh_time": "2025-01-22T20:10:26+0000",
    • "last_scan_failed": true,
    • "last_update_time": "2024-12-25T13:32:47+0000",
    • "mdm": null,
    • "name": "TEST",
    • "notes": "",
    • "needs_attention": false,
    • "needs_reboot": false,
    • "next_patch_time": "2025-01-23T06:02:00+0000",
    • "notification_count": 1,
    • "organization_id": 54321,
    • "organizational_unit": "",
    • "os_family": "Windows",
    • "os_name": "11 Home",
    • "os_version": "10.0.26100",
    • "os_version_id": 13235,
    • "patch_deferral_count": 1,
    • "patches": 2,
    • "pending": true,
    • "pending_patches": 2,
    • "policy_status": [
      • {
        • "id": 12121212,
        • "organization_id": 54321,
        • "policy_id": 250624,
        • "server_id": 123456,
        • "policy_name": "Apply All Patches",
        • "policy_type_name": "patch",
        • "status": 0,
        • "result": "{}",
        • "create_time": "2025-01-22T20:10:25+0000",
        • "will_reboot": false,
        • "pending_count": 0,
        • "next_remediation": null
        },
      • {
        • "id": 34343434,
        • "organization_id": 54321,
        • "policy_id": 901250,
        • "server_id": 123456,
        • "policy_name": "Apply Critical Patches",
        • "policy_type_name": "patch",
        • "status": 1,
        • "result": "{}",
        • "create_time": "2025-01-22T20:10:25+0000",
        • "will_reboot": false,
        • "pending_count": 0,
        • "next_remediation": null
        }
      ],
    • "reboot_deferral_count": 0,
    • "reboot_is_delayed_by_notification": false,
    • "reboot_is_delayed_by_user": false,
    • "reboot_notification_count": 0,
    • "refresh_interval": 360,
    • "serial_number": "AB123ZX",
    • "server_group_id": 654321,
    • "server_policies": [ ],
    • "status": {
      • "device_status": "not-ready",
      • "agent_status": "disconnected",
      • "policy_status": "non-compliant",
      • "policy_statuses": [
        • {
          • "id": 12121212,
          • "compliant": false
          },
        • {
          • "id": 34343434,
          • "compliant": true
          }
        ]
      },
    • "tags": [ ],
    • "timezone": "UTC-0500",
    • "total_count": 1,
    • "uptime": "170878",
    • "uuid": "1b597490-18f9-4ef4-957d-5e986921ebc1"
    }
]