---
title: "Get a device"
method: GET
path: "/api/v2/eudm/devices/{device_id}"
tags: ["End User Device Monitoring"]
---

# Get a device

`GET /api/v2/eudm/devices/{device_id}`

## Request

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

## Path parameters

- `device_id` string, required

## Response `200`

OK

- DeviceDetails: Response body for the get device endpoint, returning a single device with full attribute detail.
  - `data` DeviceDetailsData: A single device entry with full attribute detail.
    - `attributes` DeviceDetailsDataAttributes: Extended set of attributes for a single End User Device Monitoring device, including Cloud Network Monitoring and battery metrics.
      - `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_charge_pct` integer: Current battery charge level as a percentage between 0 and 100.
      - `battery_charge_rate` integer: Rate at which the battery is charging or discharging, in milliamperes. Negative values indicate discharge.
      - `battery_critical` boolean: Whether the device's battery health has degraded to a critical level.
      - `battery_cycle_count` integer: Number of full charge cycles the battery has gone through.
      - `battery_max_capacity_pct` integer: Maximum battery capacity expressed as a percentage of the device's design capacity.
      - `cnm_enabled` boolean: Whether Cloud Network Monitoring is enabled on the device.
      - `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.
      - `packet_sent` number, double: Number of TCP packets sent by the device over the query window, as reported by Cloud Network Monitoring.
      - `resource_id` string: Datadog resource identifier for the device.
      - `retransmit` number, double: Number of TCP packets retransmitted by the device over the query window.
      - `retransmit_pct` number, double: Percentage of sent TCP packets that were retransmitted, between 0 and 100.
      - `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.
      - `tcp_canceled` number, double: Number of TCP connection attempts canceled by the device over the query window.
      - `tcp_established` number, double: Number of TCP connections established by the device over the query window.
      - `tcp_establishment_failure_pct` number, double: Percentage of TCP connection attempts that failed, between 0 and 100.
      - `tcp_establishment_failures` number, double: Number of TCP connection attempts that failed over the query window.
      - `tcp_host_unreachable` number, double: Number of TCP connection attempts that failed because the host was unreachable.
      - `tcp_network_unreachable` number, double: Number of TCP connection attempts that failed because the network was unreachable.
      - `tcp_refusals` number, double: Number of TCP connection attempts refused by the remote host over the query window.
      - `tcp_timeouts` number, double: Number of TCP connection attempts that timed out over the query window.
      - `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.

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too many requests

## Changes

- **2026-11-12** `6cc2bb1f7a80`: 2 info
  - added the optional property `errors/items/code` to the response with the `400` status
  - added the optional property `errors/items/code` to the response with the `404` 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/:device_id/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)
