List devices for the calling staff API token user (scope sync:read)

GET/api/v1/sync/devices

Authorization

AuthorizationBearer token · headerrequired

Scoped API token (bnx_…). Required scopes are noted per operation.

Responses

200

Registered devices; plaintext tokens are never returned here

itemsobject[]required

Show properties

Array of object

idstringrequired

namestringrequired

platformstring | nullrequired

createdAtstringrequired

lastSeenAtstring | nullrequired

revokedbooleanrequired

totalintegerrequired

min 0

401

Unauthenticated

errorstringrequired

codestringrequired

rulestring

403

Forbidden (missing scope or permission)

errorstringrequired

codestringrequired

rulestring

429

Rate limited

errorstringrequired

codestringrequired

rulestring

Request

curl -X GET '/api/v1/sync/devices' \
  -H 'Authorization: Bearer YOUR_TOKEN'

const response = await fetch("/api/v1/sync/devices", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "/api/v1/sync/devices",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "items": [
    {
      "id": "string",
      "name": "string",
      "platform": "string",
      "createdAt": "string",
      "lastSeenAt": "string",
      "revoked": true
    }
  ],
  "total": 0
}

{
  "error": "string",
  "code": "string",
  "rule": "string"
}

{
  "error": "string",
  "code": "string",
  "rule": "string"
}

{
  "error": "string",
  "code": "string",
  "rule": "string"
}