Endpoint connectivity status

GET

https://iot.telia.lt/api/v1/endpoint/:endpoint_id/connectivity

GET

/api/v1/endpoint/:endpoint_id/connectivity

curl https://iot.telia.lt/api/v1/endpoint/1/connectivity \
     -H "Authorization: Bearer <token>"

{
  "status": {
    "description": "ONLINE"
  },
  "location": {
    "country": {
      "country_code": 49,
      "country_id": 74,
      "iso_code": "de",
      "mcc": 262,
      "name": "Germany"
    },
    "iccid": 8988303010000000000,
    "imsi": 901439999999999,
    "last_updated": "2019-12-03T07:06:04.000Z",
    "last_updated_gprs": "2019-12-30T14:55:35.000Z",
    "msc": 491770940000,
    "operator": {
      "country": {
        "id": 74,
        "name": "Germany"
      },
      "id": 4,
      "name": "EPlus"
    },
    "sgsn_ip_address": "212.23.107.88",
    "sgsn_number": 491770695700,
    "vlr_number": 491770940000
  },
  "pdp_context": {
    "ci": null,
    "created": "2019-12-04T08:12:02.000Z",
    "duration": "00:00:04",
    "endpoint_id": 166,
    "ggsn_control_plane_ip_address": "185.57.216.35",
    "ggsn_data_plane_ip_address": "185.57.216.35",
    "gtp_version": 1,
    "imeisv": 3526510721968301,
    "imsi": 901439999999999,
    "imsi_id": 627,
    "lac": 40217,
    "mcc": 262,
    "mnc": 3,
    "nsapi": 5,
    "operator_id": 4,
    "organisation_id": 2,
    "pdp_context_id": 92415,
    "rac": null,
    "rat_type": {
      "description": "3G",
      "rat_type_id": 1
    },
    "ratezone_id": 70,
    "sac": 42937,
    "sgsn_control_plane_ip_address": "212.23.107.89",
    "sgsn_data_plane_ip_address": "212.23.107.89",
    "sim_id": "625",
    "tariff_id": 54,
    "tariff_profile_id": 35,
    "teid_control_plane": 7116,
    "teid_data_plane": 7116,
    "ue_ip_address": "10.199.5.223"
  },
  "services": [
    "GPRS"
  ]
}

Retrieve details about current connectivity status of endpoint. The following is a list of possible statuses:

ATTACHED: The Endpoint has succesfully attached to the Home Core network in the past. The device will be shown as ATTACHED until the visited network has signaled that the device is inactive/offline. Usually the visited network informs the Core Network within 1-2 days after a device went offline.
ONLINE: The Endpoint has an active data connection
OFFLINE: The Endpoint has not attached to the core network yet or the device was previously attached but the visited network signaled that the device had no activity for the last 1-2 days. Note: The device is not reachable for external services (e.g. SMS, MSRN lookup).
BLOCKED: The device is not granted service. Endpoints are assigned this status when they have exceeded traffic limits.

Authentication

AuthorizationBearer

An auth_token should be provided to authenticate a session.

To obtain an auth_token, see the /api/v1/authenticate POST request.

Path parameters

endpoint_idintegerRequired

Numeric ID of an endpoint

Response

Success

statusobjectOptional

locationobjectOptional

pdp_contextobjectOptional

serviceslist of stringsOptional

Errors

403

Forbidden Error