Get device by ID

GET 
/seb-api/v1/devices/:id

Retrieve a device by ID.

Request

Path Parameters

id stringrequired

Device ID

Responses

200

A device

application/json

Schema

Schema

arch stringrequired

Architecture

browserVersion stringrequired

Browser Version

crowdstrikeZTA object
CID stringrequired
osScore integerrequired
score integerrequired
sensorScore integerrequired
deviceEPP object
enabled booleanrequired
products object[]required
Array [
name stringrequired
state stringrequired
version stringrequired
]
deviceManagement object
status stringrequired
Possible values: [managed, unmanaged]
systems object[]required
Device Management
Array [
details string
system string
Possible values: [ad, azureAd, intune, jamf]
]
devicePassword object
enabled booleanrequired
passwordPolicy object
complexityReq booleanrequired
maxPasswordAge integerrequired
minPasswordLength integerrequired
deviceType stringrequired

Possible values: [unknown, desktop, laptop, vm, smartphone, tablet, chromebook]

Device Type

diskEncryptionStatus stringrequired

Possible values: [DiskEncryptionStatusUnknown, DiskEncryptionStatusDisabled, DiskEncryptionStatusEnabled]

Disk Encryption Status

externalId stringrequired

External identifier

firewallStatus stringrequired

Possible values: [FireWallStatusUnknown, FireWallStatusDisabled, FireWallStatusEnabled]

Firewall Status

firstSeen date-timerequired

First seen time

hostname stringrequired

Hostname

id stringrequired

Unique identifier

ip stringnullable

IP Address

lastSeen date-timerequired

Last seen time

macAddresses string[]required

MAC Addresses

model stringrequired

Device Model

nativeArch stringrequired

Native Architecture

osType stringrequired

Possible values: [windows, macOS, linux, ios, android, unknown]

Operating System type

osVersion stringrequired

OS Version

screenLockStatus stringrequired

Possible values: [ScreenLockStatusUnknown, ScreenLockStatusDisabled, ScreenLockStatusEnabled]

Screen Lock Status

serialNumber stringrequired

Serial Number

systemIntegrity object

services objectrequired

SIP boolean

driversSigningEnforcement boolean

gatekeeper boolean

kernelDebugger boolean

secureBoot boolean

status stringrequired

Possible values: [pass, fail, unknown]

talonExtensionVersion stringrequired

Talon Extension Version

user object
deletedTime date-timerequired
Deleted Time
deviceIds string[]
Device IDs
email stringrequired
Email
externalId stringrequired
External identifier
firstSeen date-timerequired
First seen time
id stringrequired
Unique identifier
lastSeen date-timerequired
Last seen time
name stringrequired
Name
profilePictureURL stringrequired
Profile Picture URL
provider stringrequired
Possible values: [saml, local, oidc]
Provider
userGroups object[]
User Groups
Array [
createdAt date-time
Created at
id stringrequired
Unique identifier
lastUpdated date-time
Last updated
name stringrequired
Name
provider string
Possible values: [sso, local]
Provider
]
userAgent stringrequired

User Agent

Example (from schema)

{
  "arch": "string",
  "browserVersion": "string",
  "crowdstrikeZTA": {
    "CID": "string",
    "osScore": 0,
    "score": 0,
    "sensorScore": 0
  },
  "deviceEPP": {
    "enabled": true,
    "products": [
      {
        "name": "string",
        "state": "string",
        "version": "string"
      }
    ]
  },
  "deviceManagement": {
    "status": "managed",
    "systems": [
      {
        "details": "string",
        "system": "ad"
      }
    ]
  },
  "devicePassword": {
    "enabled": true,
    "passwordPolicy": {
      "complexityReq": true,
      "maxPasswordAge": 0,
      "minPasswordLength": 0
    }
  },
  "deviceType": "unknown",
  "diskEncryptionStatus": "DiskEncryptionStatusUnknown",
  "externalId": "string",
  "firewallStatus": "FireWallStatusUnknown",
  "firstSeen": "2024-07-29T15:51:28.071Z",
  "hostname": "string",
  "id": "string",
  "ip": "string",
  "lastSeen": "2024-07-29T15:51:28.071Z",
  "macAddresses": [
    "string"
  ],
  "model": "string",
  "nativeArch": "string",
  "osType": "windows",
  "osVersion": "string",
  "screenLockStatus": "ScreenLockStatusUnknown",
  "serialNumber": "string",
  "systemIntegrity": {
    "services": {
      "SIP": true,
      "driversSigningEnforcement": true,
      "gatekeeper": true,
      "kernelDebugger": true,
      "secureBoot": true
    },
    "status": "pass"
  },
  "talonExtensionVersion": "string",
  "user": {
    "deletedTime": "2024-07-29T15:51:28.071Z",
    "deviceIds": [
      "string"
    ],
    "email": "string",
    "externalId": "string",
    "firstSeen": "2024-07-29T15:51:28.071Z",
    "id": "string",
    "lastSeen": "2024-07-29T15:51:28.071Z",
    "name": "string",
    "profilePictureURL": "string",
    "provider": "saml",
    "userGroups": [
      {
        "createdAt": "2024-07-29T15:51:28.071Z",
        "id": "string",
        "lastUpdated": "2024-07-29T15:51:28.071Z",
        "name": "string",
        "provider": "sso"
      }
    ]
  },
  "userAgent": "string"
}

404

Device not found

Loading...