Retrieve the daily usage for a device, for a specified period of time, segmented by day
thingspace_oauth VZ-M2M-Token In: header
M2M Session Token (How to generate an M2M session token?)
In: header
application/json
TypeScript Definitions
Use the request body type in TypeScript.
application/json
application/json
curl -X POST "https://example.com/v1/devices/usage/actions/list" \ -H "Content-Type: application/json" \ -d '{ "deviceId": { "id": "20-digit ICCID", "kind": "iccid" }, "earliest": "2023-10-25T00:00:00.000Z", "latest": "2023-10-30T00:00:00.000Z" }'{ "hasMoreData": false, "deviceId": { "id": "20-digit ICCID", "kind": "iccid" }, "usageHistory": [ { "bytesUsed": 123456, "extendedAttributes": [ { "key": "MoSMS", "value": 3 }, { "key": "MtSms", "value": 2 } ], "servicePlan": "4G-LTE data", "smsUsed": 5, "source": "Usage Feed", "timestamp": "2023-10-25T00:00:00.000Z" }, { "bytesUsed": 789, "extendedAttributes": [ { "key": "MoSMS", "value": 0 }, { "key": "MtSms", "value": 0 } ], "servicePlan": "service plan name", "smsUsed": 0, "source": "Usage Feed", "timestamp": "2023-10-26T00:00:00.000Z" } ]}{ "errorCode": 400, "errorMessage": "a brief description of the error"}The start date of the time period queried as "$datetime"
^[A-Za-z0-9]{3,32}$3 <= length <= 32The end date of the time period being queried as "$datetime"
^[A-Za-z0-9]{3,32}$3 <= length <= 32