Returns information about a single device or information about all devices that match the given parameters. Returned information includes device provisioning state, service plan, MDN, MIN, and IP address.
thingspace_oauth VZ-M2M-Token In: header
M2M Session Token (How to generate an M2M session token?)
In: header
application/json
Device information query.
TypeScript Definitions
Use the request body type in TypeScript.
Request for listing account devices.
application/json
application/json
application/json
curl -X POST "https://example.com/m2m/v1/devices/actions/list" \ -H "Content-Type: application/json" \ -d '{ "deviceId": { "id": "20-digit ICCID", "kind": "iccid" } }'{ "hasMoreData": false, "devices": [ { "accountName": "0000123456-00001", "billingCycleEndDate": "2020-05-09T20:00:00-04:00", "carrierInformations": [ { "carrierName": "Verizon Wireless", "servicePlan": "m2m4G", "state": "active" } ], "connected": false, "createdAt": "2019-08-07T10:42:15-04:00", "deviceIds": [ { "id": "10-digit MDN", "kind": "mdn" }, { "id": "15-digit IMEI", "kind": "imei" } ], "groupNames": [ "southwest" ], "ipAddress": "0.0.0.0", "lastActivationBy": "Joe Q Public", "lastActivationDate": "2019-08-07T10:42:34-04:00", "lastConnectionDate": "2020-03-12T04:23:37-04:00" } ]}{ "hasMoreData": false, "devices": [ { "accountName": "0000123456-00001", "billingCycleEndDate": "2020-05-09T20:00:00-04:00", "carrierInformations": [ { "carrierName": "Verizon Wireless", "servicePlan": "m2m4G", "state": "active" } ], "connected": false, "createdAt": "2019-08-07T10:42:15-04:00", "deviceIds": [ { "id": "10-digit MDN", "kind": "mdn" }, { "id": "15-digit IMEI", "kind": "imei" } ], "groupNames": [ "southwest" ], "ipAddress": "0.0.0.0", "lastActivationBy": "Joe Q Public", "lastActivationDate": "2019-08-07T10:42:34-04:00", "lastConnectionDate": "2020-03-12T04:23:37-04:00" } ]}{ "errorCode": "error code string", "errorMessage": "error message string"}The billing account for which a list of devices is returned. If you don't specify an accountName, the list includes all devices to which you have access.
An identifier for a single device.
Filter for a list of devices.
The name of a device state, to only include devices in that state.
Custom field names and values, if you want to only include devices that have matching values.
Only include devices that were added after this date and time.
Only include devices that are in this device group.
Only include devices that were added before this date and time.
Only include devices that have this service plan.
int320 <= value <= 500int640 <= value <= 0