Docs home

User Device List

Lists the devices a user is currently logged in on, with login counts. Use it to see why a student hit the device limit before removing a device with "Remove User Device".

GET/user/device/list
User Device List
curl --request GET \
  --url 'https://<your-api-host>/nuSource/api/v1/user/device/list?user_id=<userId>' \
  --header 'APIKEY: <your-api-key>' \
  --header 'ORGID: <your-org-id>'
{
  "code": 200,
  "message": "Success",
  "user_devices": [
    {
      "user_device_mapper_id": 7614810,
      "device_id": 5927235,
      "user_device_id": "d34233848ba571f44de337846b6fa832",
      "user_device_os": "Android 10",
      "user_device_application": "Google Chrome 125.0.0.0",
      "user_application_type": 1,
      "total_login_count": 1,
      "updated_at": 1717511662,
      "status": 1
    }
  ],
  "user_info": {
    "created_at": 1721974194,
    "last_activity": 0,
    "num_login_count": 1,
    "user_active_device": 1,
    "user_in_active_device": 0,
    "users_max_device": 0
  },
  "page_context": {
    "page": 1,
    "per_page": 50,
    "has_more_page": false,
    "total_rows": 1
  }
}

Access: Institute admins, tutors, students and parents, plus custom roles that can view learner details.

Query parameters
user_idintegerrequired
The user whose devices you want.
pageinteger
Page number, starting at 1. Default 1.
per_pageinteger
Devices per page. Default 50.
Response200application/json
codeinteger
Example: 200
messagestring
Example: Success
user_devicesobject[]
Active devices
Show child attributesHide child attributes
Example: 7614810
Use it in "Remove User Device"
Example: 5927235
The device fingerprint
Example: d34233848ba571f44de337846b6fa832
Example: Android 10
Browser or app
Example: Google Chrome 125.0.0.0
1 Web app, 2 Android app, 3 iOS app, 4 API
Example: 1
Unix timestamp
Example: 1717511662
1 active
Example: 1
user_infoobject
Show child attributesHide child attributes
Account created
Example: 1721974194
Example: 0
Sessions on active devices
Example: 1
Removed devices
Example: 0
Your institute's device limit; 0 means no limit
Example: 0
Show child attributesHide child attributes
Example: 1
Example: 50
Example: false
Example: 1

Notes: Rate limit: 30 requests per minute; going over locks you out for 30 minutes.

Updated yesterday

Ask AI