Device Management
Returns basic diagnostic information about a specified device, including connectivity, provisioning, and billing status.
Returns extended diagnostic information about a specified device, including connectivity, provisioning, billing and location status.
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 to query extended diagnostics information for a device.
Request to query extended diagnostics information for a device.
accountName*string
The Verizon billing account that the device belongs to. An account name is usually numeric, and must include any leading zeros.
deviceList*array<>
The device for which you want diagnostic information, specified by the device's MDN.
Response Body
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" } ] } ]}Changes or removes the costCenterCode value for one or more devices. PUT
Changes or removes the CostCenterCode value or customer name and address (Primary Place of Use) for one or more devices.
Returns the provisioning history of a device during a specified time period. POST
Returns the provisioning history of a specified device during a specified time period.