Release Notes Archive

New in 6.9 Generation 2

December 16, 2020

Feature Description
GetDeviceUsageHistory method enhanced to allow the use of Label to retrieve data usage. The GetDeviceUsageHistory API method has been enhanced to allow you to use the Label associated with a device to retrieve data usage. This method is part of the DeviceService.
GetAggregateDeviceUsage method enhanced to allow the use of Label to retrieve data usage. The GetAggregateDeviceUsage API method has been enhanced to allow you to use the Label associated with a device to retrieve data usage. This method is part of the DeviceService.
ChangeDeviceServicePlan method enhanced to allow you to choose a specific IP Pool group. The ChangeDeviceServicePlan API method has been enhanced to include the CarrierIpPoolName request parameter. The ChangeDeviceServicePlan is part of the CarrierService.

New in 6.7 Generation 2

November 18, 2020

Feature Description
New method for customers to detach a device from the Verizon Network. The new CancelLocation API method allows you to detach a device from the Verizon Network. This new method is part of the CarrierService.

New in 5.28 Generation 2

July 29, 2020

Feature Description
New method for customers to get Get SMS Event History for a device. The new Get SMS Event History API method allows you to get the history of mobile-originated/mobile-terminated SMS messages for a single device that were sent or received via ThingSpace, within a specified time period. This new method is part of the DeviceService.
UploadDevices API method modified for accountName parameter in request. The accountName parameter in the request body is no longer required if the customer only has access to one account. The Upload Devices API method is part of the DeviceService.
ChangeDeviceState - Deactivate API method enhanced with deleteAfterDeactivation parameter in request body. Set the deleteAfterDeactivation parameter to “true” to delete the device from the database after deactivation. The ChangeDeviceState - Deactivate API method is part of the CarrierService.

New in 5.26 Generation 2

June 3, 2020

Feature Description
New method for customers to get customer segment billing usage for an entire account, or for a specific list of devices or labels. The new GetBilledUsageList API method allows you to retrieve billed usage for a list of segmentation labels for a bulk of devices. You can retrieve device billed usage either for an entire billing account, or up to 2,000 devices identified by either EID or VIN, but not both. This new method is part of the DeviceService.

New in 5.25 Generation 2

May 6, 2020

Feature Description
New method for customers to access their own usage segment operated on devices owned by another customer.

The new SetUsageSegmentationLabels API method allows you to access your owned usage segment that is operated on devices owned by another customer. This new method is part of the Carrier Service.

New method for customers to retrieve current month billed data usage for a single line of service for a device that belongs to another customer. The new GetBilledUsage API method allows you to retrieve current month billed data usage for a single line of service for a device that belongs to another customer. This new method is part of the DeviceService.
ChangeDeviceState - Activate API method enhanced for PrimaryPlaceOfUse address parameter. If the optional parameter PrimaryPlaceOfUse address is set to a non-US or non-Canadian address, the PrimaryPlaceOfUse address will be ignored in the activation request. The ChangeDeviceState - Activate API method is part of the CarrierService.

New in 5.23 Generation 2

March 6, 2020

Feature Description
Updated SDK to include GetSubscriptionInformation method.

WSDL updated to include GetSubscriptionInformation method.

New in 5.21 Generation 2

January 9, 2020

Feature Description
UploadActivate enhanced to allow the setting of IP Addresses

The UploadActivate method has been enhanced to set IP Address on devices that are submitted for uploading to DMD and then subsequently activated.

On December 31, 2019, Verizon retired its CDMA network (1x/EVDO, 2G/3G).

If you have not moved your solution to our 4G network, your devices will no longer connect. There are multiple 4G LTE options to choose from, including Category-1 and Category-M1 choices. These industry-leading, cost-competitive, advanced-technologies enable the development of next generation solutions on the 4G LTE network. Please contact your Verizon account representative for more information.

New in 5.20 Generation 2

December 5, 2019

Feature Description
New method for customers to check the status of a provisioning order

The new CheckOrderStatus API method allows you to check the status of a provisioning order. Initially, only activations are supported. This new method is part of the Device Service.

New method for customers to get SIM Secure subscription information

The new GetSubscriptionInformation API method allows you to get SIM Secure subscription information such as the types of licenses and quantities purchased, the number of licenses assigned and how many are available. This new method is part of the Account Service.

New in 5.19 Generation 2

November 6, 2019

Feature Description
New method for Open Development customers to upload and activate devices to DMD

The new UploadActivate API method allows you to submit up to 10,000 devices for upload to the Verizon Device Management Database (DMD). Once the devices are successfully uploaded, they will be automatically submitted for activation. This new method is part of the Device Service.

New in 5.15 Generation 2

July 6, 2019

Feature Description
New method for Open Development customers to upload devices to DMD

The new UploadDevices API method allows you to submit up to 10,000 devices for upload to the Verizon Device Management Database (DMD). This new method is part of the Device Service.

New in 5.13 Generation 2

May 2, 2019

Feature Description
Set IP address when activating ChangeDeviceState now allows you to set IP Address when activating a device.

New in 5.12 Generation 2

April 4, 2019

Feature Description
GetDeviceExtendedDiagnostics now supports 5 new device kinds The GetDeviceExtendedDiagnosticsInformation API method has been enhanced to support 5 new device kinds (ICCID, ESN, MSISDN, MEID, IMEI). Prior to this release, the only device kind supported was MDN.
GoToState primaryPlaceOfUse parameter updates The primaryPlaceOfUse parameter in the GoToState API will convert state names into their 2-digit state code equivalent and will split zip codes into separate zip and zip4 formats.

New in 5.11 Generation 2

March 7, 2019

Feature Description
GetDeviceInformation now returns all Promo Codes The GetDeviceInformation API method has been enhanced to return all active promo codes associated with a device. Prior to this release, it returned a limited set of active promo codes. The promo codes are still returned as an extended attributes object.

New in 5.10 Generation 2

February 7, 2019

Feature Description
New diagnostics method The new GetDeviceExtendedDiagnosticsInformation API method returns extended diagnostic information about a specified device, including connectivity, provisioning, billing and location status. The GetDeviceDiagnosticsInformation endpoint is being deprecated.

New in 5.9 Generation 2

January 3, 2019

Feature Description
Firmware and location information added to GetDeviceDiagnosticsInformation response The GetDeviceDiagnosticsInformation response now returns information about the device firmware version and location, for accounts that are subscribed to those ThingSpace services.
More eUICC profile statuses More profile statuses have been added for eUICC devices to distinguish between profiles that have just been downloaded and those that have been enabled or disabled after download.

New in 5.7 Generation 2

November 7, 2018

Feature Description
Custom services and states added to GetDeviceInformation response The GetDeviceInformation response now returns custom service and state names as extended attributes, for devices in accounts that have custom services and states defined.
IMSI included in EidDeviceSwap callback The callback for EidDeviceSwap requests now includes the device IMSI.

New in 5.6 Generation 2

October 3, 2018

Feature Description
New API method to retrieve basic device diagnostic information The new GetDeviceDiagnosticsInformation API method returns basic diagnostic information about a specified device, including connectivity, provisioning, and billing status. The DeviceService WSDL has been updated with the new request and response.
Support for TLS in UWS Explorer and Hello World The UWS Explorer and Hello World sample applications have been recompiled with .NET Framework version 4.6, and now support TLS security for data exchange.
Support for customers without a blanket credit approval Customers applying for credit approval from Verizon can now start the activation process for devices while waiting for the approval. The ChangeDeviceState-Activate API method now returns an "on hold" callback while approval is pending. If credit is not approved within one week, the method returns a "canceled" callback message.
New, more specific callback error messages for activation issues We have replaced a generic error message with more specific error messages for several activation-related issues.

New in 5.4 Generation 2

June 28, 2018

Feature Description
Find devices by beginning or end of identifier You can use the GetDeviceList API method to find devices by matching a string against the first or last part of a device identifier, in addition to the existing option to match a string against any part of a device identifier.
Set customer name and address in GoToState request

You can now set a line's customer name and address (Primary Place of Use) in the GoToState API method. The information can be used to contact the customer, if necessary, and the zip code will be used to determine tax jurisdiction.

The StateService WSDL has been updated for this change.

New in 5.2 Generation 2

May 2, 2018

Feature Description
Find devices by partial identifier

A new filter in the GetDeviceList API method lets you search for devices by only providing part of a device identifier. For example, you could provide the last four characters of an ICCID instead of the entire ICCID. All devices that contain the provided string in their ICCIDs would be included in the response.

The DeviceService WSDL has been updated for this change, and UWS Explorer has been enhanced to include the new functionality.

Get the status of an asynchronous request

The GetRequestStatus API method returns the current status of the processing of an asynchronous request, either Pending, Succes, or Failed.

The AccountService WSDL has been updated for this change, and UWS Explorer has been enhanced to include the new functionality.

New in 4.22 Generation 2

January 2018

Feature Description
Remove Unused Devices

A new DeleteDevices API method lets you remove deactivated devices from an account. Devices are removed immediately. You can use this method instead of contacting Verizon Customer Support to request device removal.

The DeviceService WSDL has been updated for this change, and UWS Explorer has been enhanced to include the new functionality.

New in 4.20 Generation 2

November 2017

Feature Description
Get account numbers and names

Account names and numbers are the same for most accounts, in the format ##########-##### (10 digits, a hyphen, then five more digits). Some accounts have different names, though, and you can use the new GetAccountInformation API to find out. You can provide either an account name or an account number in the request, and the response will contain both the name and number for the account.

The AccountService WSDL has been updated for this change, and UWS Explorer has been enhanced to include the new functionality.

Validate account ownership of devices

The GetDevicesInformation API accepts a list of devices and either an account name or number, and returns a validation of whether each device is in the account, plus a subset of information about each device. You can use this API to verify account ownership of devices before sending other API requests that would return errors if devices are not in a specified account.

The DeviceService WSDL has been updated for this change, and UWS Explorer has been enhanced to include the new functionality.

Find SIM-to-device mismatches

Original equipment manufacturers (OEMs) upload device information to Verizon, and for some devices that includes the ID of the device that a particular SIM card is expected to be installed in. SIMs may be moved between devices, though, so the expected pairing doesn't always occur, or may change once the SIM is in use. The new GetImeiMismatch API checks a provided list of devices to see if the SIMs were activated in different device during a specified time frame.

The DeviceService WSDL has been updated for this change, and UWS Explorer has been enhanced to include the new functionality.

New in 4.16 Generation 2

July 2017

Feature Description
SMS usage separated into mobile-originated and mobile-terminated messages

The GetDeviceUsageHistory response and the GetAggregateDeviceUsage callback now show separate totals for the number of SMS messages sent to devices (mobile terminated, or MT) and received from devices (mobile originated, or MO), as well as the total number of SMS messages during a reporting period.

There are no WSDL or schema updates required for this change, so the SDK has not been updated.

Roaming Country

The GetDeviceInformation and GetDeviceList responses now include a new RoamingCountry extended attribute that contains the name of a country if RoamingStatus = Roaming, or empty if NotRoaming.

There are no WSDL or schema updates required for this change, so the SDK has not been updated.

New in 4.15 Generation 2

June 2017

Feature Description
Pre-activation device availability check

The new CheckDeviceAvailability API enables you to verify that your devices are ready for new service before you request activations. The API checks that devices are certified for the Verizon Wireless Network, registered with Verizon by the manufacturer, and not already active with a mobile terminal number (MTN).

The asynchronous response is sent by a new DeviceService callback service.

The DeviceService WSDL has been updated for this change, and there is a new callback in the callback schema. UWS Explorer has also been updated to include the new functionality.

New in 4.13 Generation 2

April 2017

Feature Description
Callback retry enhancements

All callbacks now include CallbackCount and MaxCallbackThreshold parameters to provide information about callback retries for unsuccessful callbacks.

  • CallbackCount respresents the number of times the ThingSpace Platform has attempted to send the current callback. The first attempt will have a value of 1. If the callback fails (that is, the receiving system does not acknowledge receiving it), the ThingSpace Platform will try again in 5 minutes and the value will be incremented to 2. This will continue until the MaxCallbackThreshold value has been reached, and the callback will not be sent again after that.
  • MaxCallbackThreshold is the number of times that the ThingSpace Platform will attempt to send a callback. It has a fixed value of 4.

There are no WSDL or schema updates required for this change, so the SDK has not been updated. The 4.7 SDK (October 2016) is still the most current version.

New in 4.7 Generation 2

October 2016

Feature Description
GetDeviceList response can include up to 2000 devices The GetDeviceList request now accepts an optional MaxNumberOfDevices parameter to specify the maximum number of devices that the customer wants included in each response. The default value is 500, which is the number of devices per response in versions 4.6 and earlier.

New in 4.4.6 Generation 2

March 2016

Feature Description
Customer Name returned in GetLeadInformation response

The customer name is now returned as an Extended Attribute in the response to a GetLeadInformation request.

There are no WSDL or schema updates required for this change.

Pagination support in GetDeviceGroupList response By default, GetDeviceGroupList returns a single response that contains information about the first 500 device groups in an account (sorted alphabetically by name). Optional input parameters in 4.4.6 let you paginate the response by specifying the number of groups that you would like returned in each "page" of the response, and which "page" of the total set you want.

New in 4.4.5 Generation 2

November 2015

Feature Description
Ability to reactivate 4G devices immediately after deactivation The Verizon ThingSpace Platform now supports immediate activation of prior deactivated 4G SIMs without an aging requirement. This enables M2M customers to reuse and deploy SIM cards in 4G devices immediately, i.e., even within the previously mandated 50 day aging period after deactivations.
Automatic retry of failed callbacks

Unacknowledged callback messages will be retried 3 times at 5 minute intervals, for a total of 4 attempts to send the message.

Failed callback messages will be archived for 30 days. During the 30 day period, customers can contact support with the Request ID of failed callbacks and ask for them to be resent.

New callback and device information about OTA completion

The IMEI and SKU associated with a SIM can change when a device completes the Over-The-Air (OTA) Activation procedure. To help customers track these changes:

  • The ThingSpace Platform will send an ExternalProvisioningChanges callback when a device completes OTA activation.
  • The callback contains the values of the IMEI and SKU prior to OTA Activation, and the timestamp of the most recent OTA Activation.
  • The GetDeviceInformation and GetDeviceList APIs return new extended attributes containing the IMEI and SKU prior to OTA Activation and the timestamp of the most recent OTA Activation.
Callback port number restriction Beginning 11/18/2015, the ThingSpace Platform will restrict the ports you can register with Callback Service to 80, 443, 9001 to 9006 and 50551 to 50559. Existing registered ports, even if not in the allowed range, will continue to work after 11/18/2015. However, if you attempt to register a new Callback URL after 11/18/2015, you must register using an in-range port.
Mediated Usage Data The data returned by the GetAggregateDeviceUsage and GetDeviceUsageHistory APIs is now mediated instead of raw, and can be used to better estimate usage during the billing cycle. These APIs provide data that is more in line with invoices than the data returned by the GetRatedDeviceUsage API, so the latter is being deprecated. It will continue to function in the 4.4.5 release, but will return an error message in the next release.
Change in Data Retention Policy

Beginning December 1, 2015, Verizon will begin deleting historical records from the ThingSpace Platform database in keeping with the data retention policy outlined below. This action will limit the amount of historical data that you can access using the Wireless Network Services APIs.

System Logs The information contained in the Master Log, Transaction History Report and Notification Log will be kept for 12 months. Log data that is older than 12 months will be deleted.

Usage Reports The information contained in the Device Usage Report, Aggregated Usage Report and Rated Usage Report will be kept for 12 months. Log data that is older than 12 months will be deleted.

Connection Reports The information contained in the Connection History Report and Connected Session History Report will be kept for 3 months. Log data that is older than 3 months will be deleted.

If you want to retain historical data before it is deleted, please use the appropriate API to retrieve the data from the ThingSpace Platform and store it on your local resources.

New in 4.4.4 Generation 2

August 2015

Feature Description
Support for device cost center codes

Cost center codes can be set when devices are activated, and can be updated or removed at any time.

  • The ChangeDeviceState-Activate API has been enhanced to allow assigning a cost center code when activating devices. All devices in an activation request will use the same cost center code value, if specified.
  • A new ChangeDeviceCostCenter API allows changing or removing a cost center code from one or more devices.
  • The GetDeviceInformation and GetDeviceList APIs have been enhanced to return the cost center code as an extended attribute.
SKU-based activations for 4G devices with embedded SIMs

4G devices with embedded SIMs can be activated by providing the SIM ICCID and a SKU that identifies the device type.

More devices per request The maximum number of devices for APIs that accept more than one device per request has been increased from 2,000 to 10,000. (AddDevices is still limited to 200 devices per request.)