The information is returned in a callback response, so you must register a URL for DeviceUsage callback messages using the POST /callbacks API.
thingspace_oauth VZ-M2M-Token In: header
M2M Session Token (How to generate an M2M session token?)
In: header
application/json
A request to retrieve aggregated device usage history information.
TypeScript Definitions
Use the request body type in TypeScript.
Request to list device aggregate usage.
application/json
application/json
curl -X POST "https://example.com/m2m/v1/devices/usage/actions/list/aggregate" \ -H "Content-Type: application/json" \ -d '{ "deviceIds": [ { "id": "84258000000891490087", "kind": "ICCID" } ], "accountName": "9992330389-00001", "endTime": "2021-08-30T00:00:00-06:00", "startTime": "2021-08-01T00:00:00-06:00" }'{ "requestId": "1631e200-7398-4609-b1f8-398341229176"}{ "errorCode": "error code string", "errorMessage": "error message string"}The beginning of the reporting period. The startTime cannot be more than 6 months before the current date.
The end of the reporting period. The endTime date must be within on month of the startTime date.
One or more devices for which you want aggregate data, specified by device ID.
The name of a billing account.
The name of a device group, if you want to only include devices in that group.
items <= 50