Get a list of devices for a given personnel item

🔒 Requires Devices: List Devices permission.

Securitybearer
Request
path Parameters
personnelId
required
number
query Parameters
page
number >= 1
Default: 1

Which page of data are you requesting

limit
number [ 1 .. 50 ]
Default: 20

How many items are you requesting

externalId
string <= 191 characters

An externally sourced unique identifier for a device

expand[]
Array of strings

List of subcollections and sub-objects to expand

Items Enum: "asset" "complianceChecks" "documents" "identifiers"
Example: expand[]=COMPLIANCE_CHECKS
macAddress
string

The device MAC address

Example: macAddress=65-F9-3D-85-7B-6B,99-A9-3E-14-7A-3E
serialNumber
string

The device serial number

Example: serialNumber=NKRTSPY456
sourceType
string

Device source type

Enum: "AGENT" "JAMF" "INTUNE" "KANDJI" "JUMPCLOUD" "HEXNODE_UEM" "UNKNOWN" "RIPPLING" "WORKSPACE_ONE" "KOLIDE" "CUSTOM" "INTUNE_GCC_HIGH"
Example: sourceType=AGENT
Responses
200
401

Invalid Authorization

402

You must upgrade your plan to use this feature

403

You are not allowed to perform this action

404

Not Found

412

You must accept the Drata terms and conditions to use the API

500

Internal server error

get/personnel/{personnelId}/devices
Request samples 
Response samples 
application/json
{
  • "id": 1,
  • "osVersion": "MacOS 10.15.6",
  • "serialNumber": "C02T6CDJGTFL",
  • "model": "MacBook Pro",
  • "macAddress": "65-F9-3D-85-7B-6B,99-A9-3E-14-7A-3E",
  • "encryptionEnabled": false,
  • "encryptionExplanation": "No encryption provided",
  • "firewallEnabled": true,
  • "firewallExplanation": "{}",
  • "lastCheckedAt": "2025-07-01T16:45:55.246Z",
  • "sourceType": "AGENT",
  • "createdAt": "2025-07-01T16:45:55.246Z",
  • "updatedAt": "2025-07-01T16:45:55.246Z",
  • "deletedAt": "2025-07-01T16:45:55.246Z",
  • "appsCount": 20,
  • "complianceChecks": [ ],
  • "identifiers": [ ],
  • "documents": [ ],
  • "isDeviceCompliant": false,
  • "screenLockTime": 30,
  • "screenLockExplanation": {
    • "minutesIdleBeforeSleep": "2",
    • "minutesSleepingBeforePasswordIsRequired": "2"
    },
  • "antivirusEnabled": true,
  • "antivirusExplanation": "No matching app was found",
  • "autoUpdateEnabled": true,
  • "autoUpdateExplanation": "No compliances found",
  • "passwordManagerEnabled": true,
  • "passwordManagerExplanation": {
    • "passwordManagerApps": [
      • "1password 7"
      ]
    },
  • "asset": {
    • "id": 651,
    • "name": "MacBook Pro - Space Black 16-inch",
    • "description": "MacBook Pro Space Black - with 16-inch Liquid Retina XDR display",
    • "assetType": "PHYSICAL",
    • "assetProvider": "AGENT",
    • "removedAt": null,
    • "notes": null,
    • "assetReferenceType": "WORKSTATION",
    • "externalId": null,
    • "externalOwnerId": null,
    • "uniqueId": "zgf5nl7bie2qnw0z2xxx",
    • "createdAt": "2025-01-08T21:31:55.610Z",
    • "updatedAt": "2025-01-08T21:31:55.610Z"
    },
  • "userId": 1,
  • "personnelId": 1,
  • "externalId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd"
}