List enrolled devices.

get

https://api.portal.saymine.com/api/aispm/v2/public/devices

One page of the devices enrolled in your organization, with each device's last check-in, scheduled scan time,
reporting and tamper status, and how many agents and vendors were found on it. total is the number of devices
matching the filters; an oversized pageSize is reduced to the maximum; an unrecognized filter value is a 400
whose message names the accepted values; no matches returns { "total": 0, "items": [] }, not a 404.
Authenticate with an API key.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

PageNumber

int32

Zero-based page index. Absent or negative is treated as the first page.

PageSize

int32

Rows per page. Defaults to 25; the maximum is 1000 and a larger value is reduced to it. Zero or a negative value
means the default.

SortBy

string

Field to sort by, case-insensitive: EnrolledAt, DeviceId, Hostname, Platform, OsVersion,
ScannerVersion, State, LastCheckInAt, ConnectedAgentsCount, ConnectedVendorsCount. Defaults to
EnrolledAt. An unknown value is a 400 naming the accepted values.

SortDirection

string

Ascending or Descending (Asc/Desc also accepted), case-insensitive. Defaults to
Descending.

string

Case-insensitive text search over device id, hostname and local user account names.

States

array of strings

Device states to include: Pending, Approved, Rejected, Offboarded. Repeat the parameter
or comma-separate values; an unknown value is a 400 naming the accepted values. Values are combined with OR; different
filters with AND.

States

Platforms

array of strings

Operating systems to include: MacOs, Windows, Linux. Same multi-value rules as
states.

Platforms

OsArchs

array of strings

CPU architectures to include, matched exactly (for example arm64). An unknown value matches nothing.

OsArchs

ScannerVersions

array of strings

Agent versions to include, matched exactly. An unknown value matches nothing.

ScannerVersions

ReportingStatuses

array of strings

Reporting statuses to include: NeverCheckedIn, Reporting, Stopped. Same multi-value rules as
states.

ReportingStatuses

TamperStatuses

array of strings

Tamper statuses to include: Unknown, Clean, Tampered. Same multi-value rules as
states.

TamperStatuses

MinConnectedAgents

int32

Only devices with at least this many agents (for example 1 for "has at least one agent").

MinConnectedVendors

int32

Only devices whose agents connect to at least this many vendors.

Responses

Language

Credentials

Header

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Success

400Bad Request

401Unauthorized