List of devices

GET 
/seb-api/v1/devices

Retrieve a list of devices.

Request

Query Parameters

limit int32

Number of devices to return

device.hostname string

Filter by hostname.

user.name string

Filter by user name.

device.os_type string

Filter by OS type.

device.first_seen_gte date-time

Filter by first seen time or after.

device.last_seen_lte date-time

Filter by last seen time or before.

device.type string

Filter by device type.

device.firewall_status string

Filter by firewall status

device.screen_lock_status string

Filter by screen lock status.

device.disk_encryption_status string

Filter by disk encryption status

cursor string

An optional opaque string that defines from where to start listing.

sort string

Possible values: [device.hostname, device.os_type, device.browser_version, device.first_seen, device.last_seen, user.name]

The field to sort by.

order Order

Possible values: [asc, desc]

The sort order

Responses

200

A list of devices with pagination info

application/json

Schema

Schema

data object[]
Array [
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
]
pageInfo object

cursor stringnullable

When paginating forwards, the cursor to continue.

hasNextPage booleanrequired

When paginating forwards, are there more items?

Example (from schema)

{
  "data": [
    {
      "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"
    }
  ],
  "pageInfo": {
    "cursor": "string",
    "hasNextPage": true
  }
}

400

Bad request

500

Internal server error

Loading...