Get Session Details
Description
Returns information about the current or most recent data session for a given device.
Resource URL
GET rws/api/v{apiVersion}/devices/{iccid}/sessionInfo
Request Parameters
Parameter | Description |
---|---|
apiVersion |
The version number for this API. The current version for all functions is 1. |
iccid | The ICCID of the device you want information about. |
Response Parameters
Return Value | Description |
---|---|
iccid | The ICCID of the device. |
dateSessionStarted |
The time when the current or most recent data session began. For a device that has never had a session, this date is null. |
dateSessionEnded |
The time when the most recent data session ended. For a device currently in a session, this field is null. For a device that has never had a session, this date is null. |
ipAddress |
The IPv4 address used by the device during the current or most recent session. A session has at least one IP Address value (ipAddress or ipv6Address) and, in some cases, may have values for both fields. This field is always returned, even if the device does not have an IPv4 address. For a device that has never been in session, this field is null. |
ipv6Address |
The IPv6 address used by the device during the current or most recent session. A session has at least one IP Address value (ipAddress or ipv6Address) and, in some cases, may have values for both fields. This field is returned only when the device has an IPv6 address. The field never has a null value. |
Request Example
Make sure to use your own user credentials. See Authentication for information about creating an authorization header.
Response Example
Code Samples
Make sure to use the Control Center sandbox URL and your own user credentials.
Errors
Error Code | HTTP Code | Error Message |
---|---|---|
10000001 | 401 |
Invalid credentials. Description: Control Center uses this error message when the API credentials are invalid or when the IP address is not within the allowed range. |
10000024 | 400 | Invalid apiVersion. |
10000031 | 400 | Invalid Zone. |
20000001 | 404 | Resource not found - Invalid ICCID. |
30000001 | 500 | Unknown server error. |