---
title: "List endpoint devices"
method: GET
path: "/endpoint-protection/devices"
---

# List endpoint devices

`GET /endpoint-protection/devices`

## Request

- Base URL: `https://app.aikido.dev/api/public/v1`
- URL: `https://app.aikido.dev/api/public/v1/endpoint-protection/devices`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://app.aikido.io/api/oauth/token` scopes: `endpoint_protection:read`

Returns a list of all the endpoint protection devices

## Response `200`

A list of all the endpoint protection devices

- object[]
  - `id` integer: The ID of the device in Aikido
  - `name` string: The name of the device
  - `os` string: The operating system of the device
  - `version` string: The version of the Aikido endpoint protection software installed on the device
  - `serial_number` string, nullable: The hardware serial number of the device, or null if it has not been reported yet
  - `user` string: The user of the device
  - `permission_group_id` integer: The ID of the permission group related to the device
  - `permission_group_name` string: The name of the permission group related to the device
  - `last_heartbeat_at` integer: The Unix timestamp of the last heartbeat of the device sent by the Aikido endpoint protection software
  - `status` 'offline' | 'not_protected' | 'upgrade_needed' | 'protected': The status of the device

---

[API](https://skmtc.dev/aikido/apis/aikido-security-api-documentation.md) - [All operations](https://skmtc.dev/aikido/apis/aikido-security-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/aikido/apis/aikido-security-api-documentation/revisions/da8691338133?raw)