Device Management

Returns a list of network connection events for a device during a specified time period.

POST
/m2m/v1/devices/connections/actions/listHistory

Each response includes a maximum of 500 records. To obtain more records, you can call the API multiple times, adjusting the earliest value each time to start where the previous request finished.

Authorization

thingspace_oauth VZ-M2M-Token
AuthorizationBearer <token>

This is the ThingSpace token, from Credentials and Tokens is used

In: header

VZ-M2M-Token<token>

M2M Session Token (How to generate an M2M session token?)

In: header

Request Body

application/json

Query to retrieve device connection history.

Query to retrieve device connection history.

deviceId*

An identifier for a single device.

earliest*string

The earliest date and time for which you want connection events.

latest*string

The last date and time for which you want connection events.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/m2m/v1/devices/connections/actions/listHistory" \  -H "Content-Type: application/json" \  -d '{    "deviceId": {      "id": "89141390780800784259",      "kind": "iccid"    },    "earliest": "2015-09-16T00:00:01Z",    "latest": "2010-09-18T00:00:01Z"  }'
{  "connectionHistory": [    {      "connectionEventAttributes": [        {          "key": "BytesUsed",          "value": "0"        },        {          "key": "Event",          "value": "Start"        }      ],      "extendedAttributes": [],      "occurredAt": "2015-12-17T14:12:36-05:00"    },    {      "connectionEventAttributes": [        {          "key": "BytesUsed",          "value": "419863234"        },        {          "key": "Event",          "value": "Stop"        },        {          "key": "Msisdn",          "value": "15086303371"        }      ],      "extendedAttributes": [],      "occurredAt": "2015-12-19T01:20:00-05:00"    }  ],  "hasMoreData": false}