API Reference/Devices

Devices

List, search, and inspect your device fleet. Get status, health, grouping, and connectivity data.

Authentication Required

All API calls require a Bearer token via POST /v1.0/auth/login or sentinel auth login from the CLI.

GET/v1.0/devices/{corpId}

List all devices for a corporate account with pagination support. Returns device details including status, usage, network, and location data.

Parameters

corpIdstringrequired

Corporate account identifier

offsetintegerrequired

Pagination offset (0-based)

limitintegerrequired

Number of results (max 100)

sortstringrequired

Sort field (MDN, STATUS, DEVICE_NAME, LAST_30_DAYS_USED)

sortDirstringrequired

Sort direction (ASC or DESC)

sentinel devices list --corp NORTHSTAR-ISD --limit 50
sentinel_list_devices
cURL
curl "https://sentinel-api.kajeet.com/sentinel/api/v1.0/devices/NORTHSTAR-ISD?offset=0&limit=25&sort=LAST_30_DAYS_USED&sortDir=DESC" \
  -H "Authorization: Bearer $SENTINEL_TOKEN"
Response · 200 OK
{
  "totalCount": 230,
  "devices": [
    {
      "key": "5212671508",
      "mdn": "521-267-1508",
      "status": "active",
      "network": "Verizon",
      "deviceName": "Kajeet ENT-BYOD",
      "corpDescription": "Northstar Independent School District",
      "monthlyAmountUsed": 31245.43,
      "last30DaysUsed": 31245.43,
      "nickname": "Main Office Hotspot",
      "filterGroup": "Staff",
      "imei": "355737360073462",
      "onlineStatus": true
    },
    {
      "key": "3042286302",
      "mdn": "304-228-6302",
      "status": "active",
      "network": "T-Mobile",
      "deviceName": "SmartSpot AOL-BYOD",
      "corpDescription": "Northstar Independent School District",
      "monthlyAmountUsed": 8106.85,
      "last30DaysUsed": 8106.85,
      "nickname": "Bus #47",
      "filterGroup": "Student_K8",
      "onlineStatus": false
    }
  ]
}
GET/v1.0/devices/info

Look up any device by MDN, IMEI, ICCID, or ESN. Returns full device information including network, status, and configuration.

Parameters

searchstringrequired

Device identifier (MDN, IMEI, ICCID, or ESN)

sentinel devices get 521-267-1508
sentinel_get_device
cURL
curl "https://sentinel-api.kajeet.com/sentinel/api/v1.0/devices/info?search=521-267-1508" \
  -H "Authorization: Bearer $SENTINEL_TOKEN"
Response · 200 OK
{
  "key": "5212671508",
  "mdn": "521-267-1508",
  "status": "active",
  "network": "Verizon",
  "deviceName": "Kajeet ENT-BYOD",
  "corpId": "NORTHSTAR-ISD",
  "monthlyAmountUsed": 31245.43,
  "nickname": "Main Office Hotspot",
  "imei": "355737360073462",
  "ip": "10.170.18.45",
  "filterGroup": "Staff",
  "onlineStatus": true,
  "address": {
    "city": "Northstar",
    "state": "TX"
  }
}
GET/v1.0/devices/{corpId}/totals

Get device count summary — active, suspended, and total devices for a corporate account.

Parameters

corpIdstringrequired

Corporate account identifier

sentinel devices totals --corp NORTHSTAR-ISD
sentinel_device_totals
cURL
curl "https://sentinel-api.kajeet.com/sentinel/api/v1.0/devices/NORTHSTAR-ISD/totals" \
  -H "Authorization: Bearer $SENTINEL_TOKEN"
Response · 200 OK
{
  "active": 487,
  "suspended": 12,
  "total": 499
}
GET/v1.0/devices/{corpId}/{mdn}/health

Get device health metrics including signal strength, connectivity status, and diagnostics data.

Parameters

corpIdstringrequired

Corporate account identifier

mdnstringrequired

Mobile Directory Number

sentinel devices health 521-267-1508
sentinel_device_health
cURL
curl "https://sentinel-api.kajeet.com/sentinel/api/v1.0/devices/NORTHSTAR-ISD/521-267-1508/health" \
  -H "Authorization: Bearer $SENTINEL_TOKEN"
GET/v1.0/dashboard/{corpId}/deviceGroupsList/

List device groups in hierarchical order. Shows organizational structure of the device fleet.

Parameters

corpIdstringrequired

Corporate account identifier

sentinel devices groups --corp NORTHSTAR-ISD
sentinel_device_groups
cURL
curl "https://sentinel-api.kajeet.com/sentinel/api/v1.0/dashboard/NORTHSTAR-ISD/deviceGroupsList/" \
  -H "Authorization: Bearer $SENTINEL_TOKEN"
Response · 200 OK
[
  {
    "description": "Northstar ISD",
    "corpId": "NORTHSTAR-ISD",
    "selectable": false
  },
  {
    "description": "  Elementary Schools",
    "corpId": "NORTHSTAR-ELEM",
    "selectable": true
  },
  {
    "description": "  Middle Schools",
    "corpId": "NORTHSTAR-MID",
    "selectable": true
  },
  {
    "description": "  High Schools",
    "corpId": "NORTHSTAR-HIGH",
    "selectable": true
  },
  {
    "description": "  Transportation",
    "corpId": "NORTHSTAR-BUS",
    "selectable": true
  }
]