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/listUser 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
The user whose devices you want.
pageinteger
Page number, starting at 1. Default 1.
per_pageinteger
Devices per page. Default 50.
Response
codeinteger
Example:
200messagestring
Example:
Successuser_devicesobject[]
Active devices
Show child attributesHide child attributes
Example:
7614810Example:
Android 10Example:
1user_infoobject
Show child attributesHide child attributes
user_info.last_activityinteger
Example:
0user_info.user_active_deviceinteger
Example:
1page_contextobject
Show child attributesHide child attributes
page_context.pageinteger
Example:
1page_context.per_pageinteger
Example:
50page_context.has_more_pageboolean
Example:
falsepage_context.total_rowsinteger
Example:
1Notes: Rate limit: 30 requests per minute; going over locks you out for 30 minutes.