listSessionDevices
client.listSessionDevices(accessToken: string)
About this command
Lists the active session devices for the authenticated user.
The access token must include the session scope.
If the user is enrolled in MFA, the token must also include the amr:mfa claim.
|
Parameters
The authorization credential JSON Web Token (JWT) used to access the ReachFive API. |
Response
Type: Promise<SessionDevice[]>
SessionDevice[]: SessionDevice[] (1)| 1 | An array of SessionDevice objects. |
Where each SessionDevice contains the fields below.
| Item | Description |
|---|---|
|
The unique identifier for the session device. |
|
The type of authentication token associated with this device session. Values are |
|
The IP address from which the device connected or established the session. |
|
The country resolved from the device IP address at login time. |
|
The city resolved from the device IP address at login time. |
|
The operating system running on the device. |
|
The browser or client user agent name. |
|
The classification category of the device (for example, |
|
The user-friendly or system-assigned name of the device. |
|
The timestamp when the device session was initially created. |
|
The timestamp of the device’s most recent activity or network connection. |
|
The timestamp when the device session is scheduled to expire. |
[
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"tokenType": "RT",
"ip": "192.168.1.15",
"country": "France",
"city": "Asnières-sur-Seine",
"operatingSystem": "iOS 17.4",
"userAgentName": "Mobile Safari",
"deviceClass": "SmartPhone",
"deviceName": "iPhone 15 Pro",
"createdAt": "2026-07-06",
"lastConnection": "2026-07-06",
"expiresAt": "2026-07-06"
}
]