---
title: "Retrieves device protection status."
method: GET
path: "/api/v1/accounts/{accountId}/devicesprotectionstatus"
---

# Retrieves device protection status.

`GET /api/v1/accounts/{accountId}/devicesprotectionstatus`

## Request

- Base URL: `https://api.usa.cloud.watchguard.com/rest/aether-endpoint-security/aether-mgmt`
- URL: `https://api.usa.cloud.watchguard.com/rest/aether-endpoint-security/aether-mgmt/api/v1/accounts/{accountId}/devicesprotectionstatus`
- Auth: API key in header `WatchGuard-API-Key` and HTTP bearer
- TypeScript: <https://skmtc.dev/watchguard/apis/aether-endpoint-security-api/docs/api/v1/accounts/:accountId/devicesprotectionstatus/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a list of devices with their protection status and other device information. The response to this request is limited to 3,000 records.

## Path parameters

- `accountId` string, required

## Query parameters

- `top` integer
- `skip` integer
- `search` string
- `count` boolean
- `orderby` string

## Response `200`

OK

- ProtectionStatusResultFindResponse[]
  - `data` ProtectionStatusResult
    - `host_name` string: Host name of the device.
    - `device_id` string, uuid: Identification number of the device.
    - `platform_id` 1 | 2 | 3 | 4 | 5: Device platform. - 1: Windows - 2: Linux - 3: macOS - 4: Android - 5: iOS
    - `device_type` 1 | 2 | 3 | 4: Type of device. - 1: Workstation - 2: Laptop - 3: Server - 4: Mobile device
    - `accumulated_protection_status` 0 | 1 | 2 | 3 | 4 | 5 | 6: General protection status. - 0: Without protection or without information - 1: Activated - 2: Deactivated - 3: Error - 4: Error installing - 5: Without license - 6: Not available
    - `adaptive_defense_status` 0 | 1 | 2 | 3 | 4 | 5 | 6: Adaptive Defense status. - 0: Without protection or without information - 1: Activated - 2: Deactivated - 3: Error - 4: Error installing - 5: Without license - 6: Not available
    - `file_antivirus_status` 0 | 1 | 2 | 3 | 4 | 5 | 6: Antivirus status. - 0: Without protection or without information - 1: Activated - 2: Deactivated - 3: Error - 4: Error installing - 5: Without license - 6: Not available
    - `firewall_status` 0 | 1 | 2 | 3 | 4 | 5 | 6: Firewall status. - 0: Without protection/without information - 1: Enabled - 2: Disabled - 3: Error - 4: Error installing - 5: Without license - 6: Not available
    - `isolation_state` 0 | 1 | 2 | 3: Isolation state of the device. - 0: Not isolated - 1: Isolated - 2: Applying isolation - 3: Removing isolation
    - `protection_engine_update_status` 0 | 1 | 2 | 3: Adaptive Defense status. - 0: Undefined - 1: Outdated - 2: Updated - 3: Waiting for reboot
    - `protection_engine_version` string: Protection engine version.
    - `knowledge_catalog_update_status` 0 | 1 | 2: Update status of the catalog. - 0: Not available - 1: Outdated - 2: Updated
    - `knowledge_catalog_date` string, date-time: Date and time when the knowledge catalog installed on the device.
    - `last_connection_date` string, date-time: Date and time when the device last connected.
    - `reboot_requested` boolean, nullable: Indicates whether a device reboot is requested.
    - `reinstall_protection_requested` boolean, nullable: Indicates whether reinstallation of protection is requested.
    - `reinstall_agent_requested` boolean, nullable: Indicates whether reinstallation of the agent is requested.
    - `license_status` 0 | 1 | 2 | 3: Status of the license. - 0: Assigned - 1: Not assigned - 2: Manual deallocation - 3: Auto deallocation
    - `reinstall_agent_error` unknown
    - `reinstall_protection_error` unknown
  - `total_items` integer, nullable: Optionally, if Count parameter is provided, we return here the total number of items

## Other responses

- `400`: BAD REQUEST.
- `403`: ACCESS DENIED.
- `404`: NOT FOUND.
- `405`: METHOD NOT ALLOWED.
- `500`: INTERNAL ERROR.

---

[API](https://skmtc.dev/watchguard/apis/aether-endpoint-security-api.md) - [All operations](https://skmtc.dev/watchguard/apis/aether-endpoint-security-api/llms.txt) - [OpenAPI document](https://skmtc.dev/watchguard/apis/aether-endpoint-security-api/revisions/1376eee70d39?raw)