Get Devices v1

GET {{baseUrl}}/v1/device?pagination=<integer>&applicationType=webos&search=<string>&model=<string>&maxStorageStatusPercentage=<integer>&minStorageStatusPercentage=<integer>&createdSince=<string>&createdUntil=<string>

This endoint is deprecated and will be removed in the future. Use Get Devices v2 instead.

Get all devices for current Organization.

Parameters

FieldTypeRequiredDescription
applicationTypestring - ‘sssp’ , ‘tizen’ , ‘webos’ , ‘android’ , ‘linux’ , ‘default’
optional
one of supported applicationTypes
searchstring
optional
search by string contained in uid, duid, name of device, serial number, MAC address or verification hash
modelstring
optional
filter by device model matching
minStorageStatusPercentagenumber 0 – 100
optional
filter by storage usage minimal value in percentage
maxStorageStatusPercentagenumber 0 – 100
optional
filter by storage usage maximal value in percentage
paginationnumber greater than 0
optional
Start paginating result by a given number of items on the page. Next page link is available in the response header Link.

E.g.: <https://api.signageos/v1/device?pagination=50&createdUntil=2020-10-22T16%3A10%3A00.000Z>; rel="next"
createdSincestring
optional
filter by device createdAt greater than or equal (inclusive) date time in ISO-8601 format.
createdUntilstring
optional
filter by device createdAt lower than (exclusive) date time in ISO-8601 format. Internally used for pagination (see pagination parameter).

Important note

For Organizations with more than 500 devices, we strongly recommend using pagination.

Request Params

KeyDatatypeRequiredDescription
paginationstringStart paginating result by given number items on page. Next page link is available on in response under header Link. E.g.: &lt;https://api.signageos/v1/device?pagination=50&amp;createdUntil=2020-10-22T16%3A10%3A00.000Z&gt;; rel=&quot;next&quot;
applicationTypestringfilter by application type
searchstringsearch by string contained in uid, duid or name of device
modelstringfilter by device model matching
maxStorageStatusPercentagestringfilter by storage usage maximal value in percentage
minStorageStatusPercentagestringfilter by storage usage minimal value in percentage
createdSincestringfilter by device createdAt greater than or equal (inclusive) date time in ISO-8601 format.
createdUntilstringfilter by device createdAt lower than (exclusive) date time in ISO-8601 format. Internally used for pagination (see pagination parameter).

HEADERS

KeyDatatypeRequiredDescription
x-authstringAuthorization key and token
Content-Typestring
Acceptstring

RESPONSES

status: OK

[]