Get Thing Data Session Status

This guide will show you how you can view Thing (SIM) current data session status.

Get Thing data session status

GET https://console.monogoto.io/thing/status?ThingIds=ThingId_ICCID_{ICCID}

Path Parameters

Name	Type	Description
&limit=50&offset=0	String	You can add a limit and offset to the url path
ICCID	String	The ICCID of your SIM

Headers

Name	Type	Description
YOUR_TOKEN	String	Your authentication token

200: OK OK

{
  "Message": "string",
  "Success": true,
  "Data": [
    {
      "CustomerId": "string",
      "ThingId": "string",
      "ThingName": "string",
      "ThingDescription": "string",
      "ProvisionStatus": "string",
      "ActiveIMSI": "string",
      "LastConnectionTime": "string",
      "LastDisconnectionTime": "string",
      "MSISDN": "string",
      "ActiveSessions": {
        "ActiveSessionId": "string",
        "ApnName": "string",
        "IPAddress": "string",
        "LastConnectedTime": 0,
        "UplinkThroughput": 0,
        "DownlinkThroughput": 0
      }
    }
  ]
}

401: Unauthorized Unauthorized

{
    // Response
}

400: Bad Request Invalid Input Data

{
    // Response
}

500: Internal Server Error Internal Server Error

{
    // Response
}

Add your Thing ICCID and Token in the GET request to successfully obtain the Thing info.

Example using cURL:

curl -X GET \
    --url "https://console.monogoto.io/thing/status?ThingIds=ThingId_ICCID_{ICCID}&limit=50&offset=0" \
    -H "accept: application/json" \
    -H "Authorization: Bearer {TOKEN_HERE}"

Example of received result showing Thing current data session status:

{
  "Success": true,
  "Message": "Operation succeeded",
  "Data": [
    {
      "ThingId": "ThingId_ICCID_8912372646888991",
      "CustomerId": "cid_c256463da-742-491b-911b-8850177ef5121",
      "ThingName": "ICCID 8912372646888991",
      "ThingDescription": "Operator's inventor (not associated with any customer)",
      "ProvisionStatus": "ACTIVE",
      "ConnectionStatus": "CONNECTED",
      "ActiveSessions": [],
      "ActiveIMSI": "123456789101112",
      "LastConnectionTime": null,
      "LastDisconnectionTime": null,
      "MSISDN": "[phone]"
    }
  ]
}

Data session connection status explained:

CONNECTED - SIM currently has open data session (PDP)

DISCONNECTED - SIM currently does not have open data session (PDP)

The API returns the thing connection statuses and information regarding active PDP sessions

GEThttps://console.monogoto.io/thing/status

Query parameters

Response

200400401500

Successfully fetched array of things statuses

Body

application/json

Messagestring

API result message

Successboolean

Dataarray of ThingStatusItem (object)

Request

JavaScriptCurlPython

const response = await fetch('https://console.monogoto.io/thing/status', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400401500

{
  "Message": "text",
  "Success": false,
  "Data": [
    {
      "CustomerId": "text",
      "ThingId": "text",
      "ThingName": "text",
      "ThingDescription": "text",
      "ProvisionStatus": "text",
      "ActiveIMSI": "text",
      "LastConnectionTime": "text",
      "LastDisconnectionTime": "text",
      "MSISDN": "text",
      "ActiveSessions": {
        "ActiveSessionId": "text",
        "ApnName": "text",
        "IPAddress": "text",
        "LastConnectedTime": 0,
        "UplinkThroughput": 0,
        "DownlinkThroughput": 0
      }
    }
  ]
}