Device Actions

Retrieve aggregate usage

POST
/v1/devices/usage/actions/list/aggregate

Retrieve the aggregate usage for a device or a number of devices.

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

deviceId?
accountName?string

The numeric name of the account, in the format "0000123456-00001". Leading zeros must be included.

Match^[A-Za-z0-9]{3,32}$
Length3 <= length <= 32
startTime?string

The start date of the time period queried as "$datetime"

Match^[A-Za-z0-9]{3,32}$
Length3 <= length <= 32
endTime?string

The end date of the time period being queried as "$datetime"

Match^[A-Za-z0-9]{3,32}$
Length3 <= length <= 32

Response Body

application/json

application/json

curl -X POST "https://example.com/v1/devices/usage/actions/list/aggregate" \  -H "Content-Type: application/json" \  -d '{}'
{  "requestId": "d1f08526-5443-4054-9a29-4456490ea9f8"}