Get a specific device

Get a specific device

Securitybearer
Request
path Parameters
deviceId
required
number

The device ID

query Parameters
expand[]
Array of strings

List of subcollections and sub-objects to expand

Items Enum: "ASSET" "COMPLIANCE_CHECKS" "DOCUMENTS" "IDENTIFIERS" "DEVICE_APPS"
Example: expand[]=COMPLIANCE_CHECKS
Responses
200
400

Malformed data and/or validation errors

401

Invalid Authorization

402

Response Code 402

You must pay to activate this feature

403

You are not allowed to perform this action

500

Internal server error

default

Response Code: 412

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

get/devices/{deviceId}
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": "2020-07-06 12:00:00.000000",
  • "sourceType": "AGENT",
  • "createdAt": "2020-07-06 12:00:00.000000",
  • "updatedAt": "2020-07-06 12:00:00.000000",
  • "deletedAt": "2020-07-06 12:00:00.000000",
  • "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",
  • "apps": [ ]
}