---
title: "Get all devices"
method: GET
path: "/api/v2/eudm/devices"
tags: ["End User Device Monitoring"]
---

# Get all devices

`GET /api/v2/eudm/devices`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/eudm/devices`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

## Query parameters

- `bssid` string[]
- `page[limit]` integer
- `page[cursor]` string

## Response `200`

OK

- DeviceBaseArray: Response body for the list devices endpoint.
  - `data` DeviceBaseData[], required: List of devices matching the request.
    - `attributes` DeviceBaseDataAttributes: Common health and identity attributes shared by every End User Device Monitoring device record.
      - `agent_key` string: Public key of the Datadog Agent installed on the device.
      - `agent_version` string: Version of the Datadog Agent installed on the device.
      - `battery_critical` boolean: Whether the device's battery health has degraded to a critical level.
      - `battery_max_capacity_pct` integer: Maximum battery capacity expressed as a percentage of the device's design capacity.
      - `cpu_cores` integer: Number of physical CPU cores on the device.
      - `cpu_logical_processors` integer: Number of logical CPU processors (hardware threads) on the device.
      - `cpu_model` string: Human-readable name of the device's CPU model.
      - `cpu_usage` number, double: Average CPU usage on the device, as a percentage between 0 and 100.
      - `disk_usage` number, double: Average disk usage on the device, as a percentage between 0 and 100.
      - `employee` DeviceEmployee: Directory information about the employee associated with the device, sourced from a customer reference table. Absent when no reference table is configured or the device has no match.
        - `city` string: City where the employee is based.
        - `country` string: Country where the employee is based.
        - `department` string: Department the employee belongs to.
        - `email` string: Email address of the employee.
        - `name` string: Full name of the employee.
        - `office` string: Office the employee is assigned to.
        - `team` string: Team the employee belongs to.
      - `geo_ip` DeviceGeoIP: Location derived from the device's public IP address. Absent when no location data is available.
        - `geo_city` string: City resolved from the device's public IP address.
        - `geo_country_iso_code` string: ISO 3166-1 alpha-2 country code resolved from the device's public IP address.
        - `geo_latitude` number, double: Latitude resolved from the device's public IP address.
        - `geo_longitude` number, double: Longitude resolved from the device's public IP address.
        - `geo_subdivision_iso_code` string: ISO 3166-2 subdivision code (for example, a state or province) resolved from the device's public IP address.
        - `public_ip_address` string: Public IPv4 or IPv6 address of the device.
      - `ip_address` string: Last observed IPv4 or IPv6 address of the device.
      - `issues` string[]: List of issue identifiers currently affecting the device.
      - `kernel_name` string: Name of the operating system kernel running on the device.
      - `last_reboot` string: Timestamp of the most recent device reboot, in RFC 3339 format.
      - `last_seen` string: Timestamp of the most recent telemetry received from the device, in RFC 3339 format.
      - `manufacturer` string: Manufacturer of the device.
      - `mem_usage` number, double: Average memory usage on the device, as a percentage between 0 and 100.
      - `memory_total_kb` integer: Total amount of physical memory available on the device, in kilobytes.
      - `model_name` string: Marketing or product name of the device model.
      - `model_number` string: Manufacturer-assigned model number of the device.
      - `os` string: Operating system family running on the device, as reported by the Datadog Agent (for example, `macOS`, `Windows`, or `linux`). Empty when unknown.
      - `os_version` string: Operating system version running on the device.
      - `resource_id` string: Datadog resource identifier for the device.
      - `serial_number` string: Serial number assigned to the device by its manufacturer.
      - `status` 'healthy' | 'degraded' | 'critical' | 'inactive' | 'unknown': Health status of the device, computed from its issues and recent telemetry. `inactive` means the device stopped reporting. `unknown` means no telemetry is available yet.
      - `type` string: Hardware type of the device (for example, `laptop` or `desktop`). `unknown` when the type cannot be determined.
      - `uptime` number, double: Time elapsed since the device last booted, in seconds.
      - `wlan_bssid` string: BSSID (MAC address of the access point) of the wireless network the device is currently connected to.
      - `wlan_rssi` number, double: Received signal strength indicator of the device's current wireless connection, in dBm.
      - `wlan_ssid` string: SSID of the wireless network the device is currently connected to.
    - `id` string, required: Unique identifier of the device. Matches the Datadog host identifier.
    - `type` 'devices', required: Devices resource type.
  - `links` DeviceBaseArrayLinks: Links related to the current page of devices.
    - `next` string: URL of the next page of devices. Present only when more devices remain.
    - `self` string: URL of the current request.
  - `meta` DeviceBaseArrayMeta: Metadata about the list devices response.
    - `page` DeviceBaseArrayMetaPage: Pagination information for the list devices response.
      - `after` string: Cursor to pass as `page[cursor]` to get the next page. Present only when more devices remain.

## Other responses

- `400`: Bad Request
- `429`: Too many requests

## Changes

- **2026-11-12** `6cc2bb1f7a80`: 1 info
  - added the optional property `errors/items/code` to the response with the `400` status
- **2026-11-10** `85012c183b21`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/changes/api/v2/eudm/devices/get.md)

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/14d85160bfa9?raw)
