Device Reports

A daily usage report for a single device for a specified date range (up to 180 days).

POST
/hyper-precise/v1/report/sessions

Detailed report of session duration and number of bytes transferred per day.

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 for sessions report.

Request for sessions report.

accountNumber*string

The numeric ID of the account and must include leading zeroes. This value is indentical to accountName.

imei*string

The International Mobile Equipment Identifier of the device.

startDate?string

Start date of session to include. If not specified information will be shown from the earliest available (180 days). Can be either date in ISO 8601 format or predefined constants.

endDate?string

End date of session to include. If not specified information will be shown to the latest available. Can be either date in ISO 8601 format or predefined constants.

durationLow?integer

Optional filter — minimum session duration

Formatint32
durationHigh?integer

Optional filter — maximum session duration

Formatint32

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/hyper-precise/v1/report/sessions" \  -H "Content-Type: application/json" \  -d '{    "accountNumber": "0000123456-00001",    "startDate": "2022-12-09T22:01:06.217Z",    "endDate": "2022-12-09T22:01:08.734Z",    "imei": "15-digit IMEI",    "durationLow": 0,    "durationHigh": 0  }'
{  "id": "The 10-digit ID of the device",  "txid": "60c07fff-eeee-ffff-gggg-75e6a7c238f6",  "sessions": [    {      "startTime": "Start date of session. ISO 8601 format.",      "endTime": "End date of session. ISO 8601 format.",      "numBytes": 0    }  ]}