Returns extended diagnostic information about a specified device, including connectivity, provisioning, billing and location status.
thingspace_oauth VZ-M2M-Token In: header
M2M Session Token (How to generate an M2M session token?)
In: header
application/json
Request to query extended diagnostics information for a device.
TypeScript Definitions
Use the request body type in TypeScript.
Request for obtaining device extended diagnostics.
application/json
application/json
curl -X POST "https://example.com/m2m/v1/devices/extendeddiagnostics/actions/list" \ -H "Content-Type: application/json" \ -d '{ "accountName": "0000123456-00001", "deviceList": [ { "id": "10-digit MDN", "kind": "mdn" } ] }'{ "accountName": "0000123456-00001", "deviceList": [ { "id": "15-digit IMEI", "kind": "imei" } ], "categories": [ { "categoryName": "DeviceIdentifier", "extendedAttributes": [ { "key": "ICCID", "value": "20-digit ICCID" }, { "key": "IMEI", "value": "15-digit IMEI" }, { "key": "IMSI", "value": "15-digit IMSI" }, { "key": "MDN", "value": "10-digit phone number" }, { "key": "MIN", "value": "10-digit phone number" }, { "key": "MSISDN", "value": "1+ 10-digit phone number" } ] }, { "categoryName": "DeviceAttributes", "extendedAttributes": [ { "key": "AccountName", "value": "0000123456-00001" }, { "key": "GroupName", "value": "Default: 0000123456-00001" }, { "key": "DeviceSku", "value": "VZW080000100112" }, { "key": "CustomFields1", "value": "5G SA FWA site" }, { "key": "ServicePlanType", "value": "Public Dynamic" }, { "key": "FeatureCodes", "value": "84777,86112" }, { "key": "FeatureNames", "value": "84777,86112" }, { "key": "FeatureTypes", "value": "4G PUBLIC DYNAM IP DSS STREAM,5G IPV/IPV6 IP" }, { "key": "BundleSku", "value": "TSS-IOT-INTELLIGENCE-CUSTOM" }, { "key": "RatePlanCode", "value": "5GBI100MBPS" }, { "key": "DeviceMake", "value": "ODI" }, { "key": "DeviceModel", "value": "DIGI - EX50-WXS6-GLB" }, { "key": "ModemGeneration", "value": "5G" }, { "key": "4GDeviceDetectionDate", "value": "2024-09-25T22:18:07Z" }, { "key": "Services", "value": "null" }, { "key": "ModemType", "value": "5GE" }, { "key": "DiagnosticsEligibility", "value": "StreamEligible" }, { "key": "DiagnosticsSKUName", "value": "TSS-IOT-INTLG-CUSTOM-DIAG-LWM2M" }, { "key": "AvailableNetworks", "value": "6" }, { "key": "ModemCategory", "value": "IoT Module" } ] }, { "categoryName": "Provisioning", "extendedAttributes": [ { "key": "LastActivationBy", "value": "Verizon, User" }, { "key": "LastActivationDate", "value": "2024-09-25T00:10:24Z" }, { "key": "CreatedAt", "value": "2024-09-24T20:56:12Z" }, { "key": "DeviceState", "value": "active" }, { "key": "LastDeactivationDate", "value": "2024-09-25T00:05:21Z" } ] }, { "categoryName": "Connectivity", "extendedAttributes": [ { "key": "Connected", "value": "true" }, { "key": "LastConnectionDate", "value": "2025-03-14T13:12:01.000Z" }, { "key": "IPAddress", "value": "10.0.0.0" }, { "key": "LastDisconnectDate", "value": "2025-03-14T08:34:43.000Z" }, { "key": "RoamingStatus", "value": "false" }, { "key": "RomaingLastModifiedDate", "value": "2025-03-14T13:12:01.000Z" }, { "key": "RequiredAPN", "value": "The Access point name" } ] }, { "categoryName": "Billing", "extendedAttributes": [ { "key": "BillingCycleStartDate", "value": "2024-09-25T12:00:00Z" }, { "key": "BillingCycleEndDate", "value": "2024-09-25T12:00:00Z" }, { "key": "DefaultRatePlan", "value": "0" } ] }, { "categoryName": "Usage", "extendedAttributes": [ { "key": "CurrentRatedUsageRecordDate", "value": "2024-09-25T00:00:00Z" }, { "key": "CurrentBillCycleDataRatedUsage", "value": "0" }, { "key": "CurrentBillCycleRatedSMSUsage", "value": "0" }, { "key": "PromoSmsUsage", "value": "0" }, { "key": "PromoSmsUsagePercent", "value": "0" }, { "key": "PromoDataUsage", "value": "0" }, { "key": "PromoDataUsagePercent", "value": "0" }, { "key": "AaaPromoDataUsage", "value": "0" }, { "key": "RtrPromoDataUsage", "value": "0" }, { "key": "InternationalRoamingUsage", "value": "0" } ] }, { "categoryName": "Location", "extendedAttributes": [ { "key": "LocationSkuName", "value": "TSS-IOT-INTLG-CUSTOM-LOC-COARSE" }, { "key": "LastLocationUpdate", "value": "2024-06-17T16:23:14Z" }, { "key": "Latitude", "value": "33.122153" }, { "key": "Longitude", "value": "-96.641825" }, { "key": "LastLocationAttemptDate", "value": "2024-09-25T16:23:14Z" }, { "key": "LastLocationStatus", "value": "122" } ] }, { "categoryName": "FOTA", "extendedAttributes": [ { "key": "FotaCurrentFirmwareVersion", "value": "SWIX55C_03.09.11.00" }, { "key": "FotaSku", "value": "TSS-IOT-INTLG-CUSTOM-SWMT" }, { "key": "FotaMake", "value": "Sierra Wireless" }, { "key": "FotaModel", "value": "EM9191" }, { "key": "FotaProtocol", "value": "LWM2M" } ] }, { "categoryName": "PrimaryPlaceOfUse", "extendedAttributes": [ { "key": "CustomerFirstName", "value": "first name" }, { "key": "CustomerLastName", "value": "last name" }, { "key": "CustomerAddressLine1", "value": "street number and name" }, { "key": "CustomerAddressCity", "value": "PLANO" }, { "key": "CustomerAddressState", "value": "TX" }, { "key": "CustomerAddressZipCode", "value": "75075" }, { "key": "CustomerCountry", "value": "USA" }, { "key": "CustomerPpuLatitude", "value": "latitude in decimal degrees" }, { "key": "CustomerPpuLongitude", "value": "longitude in decimal degrees" } ] }, { "categoryName": "SIMSECURE" }, { "categoryName": "RTR", "extendedAttributes": [ { "key": "RTRUnRatedDataUsage", "value": "0" } ] }, { "categoryName": "PMEC", "extendedAttributes": [ { "key": "IsPmec", "value": "false" } ] }, { "categoryName": "RfAttributes", "extendedAttributes": [ { "key": "CellID", "value": "cellular ID" }, { "key": "CellIDUpdatedDate", "value": "2024-09-25T21:35:50Z" }, { "key": "CellIDStreamStatus", "value": "ObserveInprogress" }, { "key": "CellIDIntervalInSeconds", "value": "15" }, { "key": "CellIDDurationInSeconds", "value": "900" }, { "key": "NetworkBearer", "value": "6" }, { "key": "NetworkBearerUpdateDate", "value": "2024-09-25T21:35:50Z" }, { "key": "NetworkBearerStreamStatus", "value": "ObserveInprogress" }, { "key": "NetworkBearerIntervalInSeconds", "value": "15" }, { "key": "NetworkBearerDurationInSeconds", "value": "900" }, { "key": "RadioSignalStrength", "value": "-59" }, { "key": "RadioSignalStrengthUpdatedDate", "value": "2024-09-25T21:35:50Z" }, { "key": "RadioSignalStrengthStreamStatus", "value": "ObserveDurationExpired" }, { "key": "RadioSignalStrengthIntervalInSeconds", "value": "15" }, { "key": "RadioSignalStrengthDurationInSeconds", "value": "3600" }, { "key": "LinkQuality", "value": "-11" }, { "key": "LinkQualityUpdatedDate", "value": "2024-09-25T21:35:50Z" }, { "key": "LinkQualityStreamStatus", "value": "ObserveInprogress" }, { "key": "LinkQualityIntervalInSeconds", "value": "15" }, { "key": "LinkQualityDurationInSeconds", "value": "3600" } ] }, { "categoryName": "Battery", "extendedAttributes": [ { "key": "BatteryLevel", "value": "0" } ] }, { "categoryName": "Restart", "extendedAttributes": [ { "key": "DeviceRebootStatus", "value": "REBOOT_QUEUED" }, { "key": "DeviceRebootStatusDate", "value": "2024-05-07T14:21:59Z" }, { "key": "DeviceRebootStatusErrorCode", "value": "DEVICE_UNREACHABLE" }, { "key": "DeviceRebootStatusErrorDescription", "value": "Device not reachable, request will send to device once it become available" } ] } ]}{ "errorCode": "error code string", "errorMessage": "error message string"}The Verizon billing account that the device belongs to. An account name is usually numeric, and must include any leading zeros.
The device for which you want diagnostic information, specified by the device's MDN.