Device Management

Obtain the usage history of a specific device.

POST
/m2m/v1/devices/usage/actions/list

Returns the network data usage history of a device during a specified time period.

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

Request to obtain usage history for a specific device.

Request to obtain usage history for a specific device.

earliest*string

The earliest date for which you want usage data.

latest*string

The last date for which you want usage data.

deviceId?

An identifier for a single device.

label?

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/m2m/v1/devices/usage/actions/list" \  -H "Content-Type: application/json" \  -d '{    "deviceId": {      "id": "50684915885088839315521399821675",      "kind": "eid"    },    "earliest": "2018-03-20T00:00:01Z",    "latest": "2020-12-31T00:00:01Z"  }'
{  "hasMoreData": false,  "usageHistory": [    {      "bytesUsed": 4096,      "extendedAttributes": [        {          "key": "MoSms",          "value": "0"        }      ],      "smsUsed": 0,      "source": "Raw Usage",      "timestamp": "2020-12-01T00:00:00Z"    }  ]}