Get Device

GET /clients/{client_id}/devices/{device_id}

Returns the full Device object for a single device. Use this endpoint to load a device detail page, or to fetch a single device after a related operation.

When to use Get Device vs List Devices

Use case	Endpoint
Load a device detail page by ID	GET /devices/{id}
Refresh one device after viewing it	GET /devices/{id}
Browse all devices in the org	GET /devices
Find devices for a specific user	GET /devices?user_id=

Path Parameters

Parameter	Type	Description
client_id	string (uuid)	Unique identifier for the client organization
device_id	string (uuid)	Unique identifier for the device

Response

Returns a single Device object.

Example Request

curl -X GET "https://api.example.com/v2/clients/aa7cf840-9ca9-46a3-9778-9015d6580d50/devices/f1e2d3c4-b5a6-7890-abcd-ef1234567890" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Example Response

{
  "id": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
  "name": "DESKTOP-DEV-ALICE",
  "status": "active",
  "serial_number": "5CG1234567",
  "unique_key": "DESKTOP-DEV-ALICE-HWID-5CG1234567",
  "os_name": "Windows",
  "os_version": "10.0.19045",
  "last_seen_at": "2026-02-24T21:23:53.082Z",
  "installed_at": "2025-11-01T08:00:00.000Z",
  "agent_version": "1.2.3",
  "hardware": {
    "manufacturer": "Dell Inc.",
    "model": "XPS 15 9520",
    "cpu_model": "Intel(R) Core(TM) i7-12700H",
    "cpu_cores": 8,
    "ram": 17179869184
  },
  "extensions": {
    "chrome": {
      "version": "1.11.0",
      "installed": true,
      "auto_update": true,
      "last_activity_at": "2026-02-24T21:23:53.082Z"
    },
    "edge": {
      "version": "1.11.0",
      "installed": true,
      "auto_update": false,
      "last_activity_at": "2026-02-24T21:22:00.000Z"
    },
    "firefox": {
      "version": null,
      "installed": false,
      "auto_update": false,
      "last_activity_at": null
    }
  },
  "created_at": "2025-11-01T08:00:00.000Z",
  "updated_at": "2026-02-24T21:23:53.082Z"
}

Device Status Values

Status	Description
active	Device is reporting heartbeats regularly
inactive	Device has not reported recently
pending	Device is enrolled but has not completed initial setup

Error Responses

Status	Description
401	Authentication required
403	Insufficient permissions for this client
404	Device or client not found
500	Server error

Example Error Response

{
  "error": {
    "code": "not_found",
    "message": "Device not found",
    "details": {
      "device_id": "f1e2d3c4-b5a6-7890-abcd-ef1234567890"
    }
  }
}

Loading Device Details with Deployments

The device detail page typically displays deployment status alongside device information. Load both in parallel:

GET /clients/{client_id}/devices/{device_id}
GET /clients/{client_id}/devices/{device_id}/deployments

The device endpoint returns hardware, OS, and extension info. The deployments endpoint returns enrollment history. Together they provide the complete device detail view.

Related Endpoints

• List Devices - Paginated list of all devices
• Device Users - Users observed on this device
• Device Deployments - Enrollment deployment history and logs