What’s New in the Connectivity Management API

12/06/2022 - Release 6.53.2

  • TS Intelligent Engine:
    • Support Change Plan action on all usage alert types - changes in:
      • DataGrid
      • NP_Radius
      • Rules Engine
      • TSM Portal
  • Key Production Bug Fixes:
    • Pentest fix in IdentityManager

11/28/2022 - Release 6.53.1

  • UCRM :
    • Improve error message when a router is offline or not powered on
    • Apply filters from the dashboard in a combined experience

11/16/2022 - Release 6.53

  • Key Production Bug Fixes:
    • Reports/TSM/URS: Additional handling for special characters on downloaded reports
    • 5G Business Internet: Usage Reports for 5GBI devices showing no Usage Data
    • User unable to see pool group dropdown selecting private network plans 
    • Global portal: Editing UWS account org field taking longer than expected

10/23/2022 - Release 6.52

  • FOTA (in the portal): 
    • Fixed issues with CampaignFailed and CampaignEnded notification not going to portal
    • Fixed issue with campaign page not displayed in portal if campaign invoked by API
    • Fixed issue with Portal having invalid cancel campaign criteria
    • Fixed issue with older Firmware Version Displaying on Devices Page
    • Fixed issue with V1 and V2 showing different current and new software versions
  • Key Production Bug Fixes:
    • Global: Correct Error Message when passing the ICCID or EID as NULL
    • FOTA: Fix issue with creating 10K campaign in the portal

10/07/2022 - Release 6.51

  • FOTA (in the portal): 
    • Bug fix for the Device Upgrade status Report in TS 2.0
  • Key Production Bug Fixes:
    • Showcase App: UWS not populating ServiceStateDate and CRBPhoneType

09/23/2022 - Release 6.50

  • TS 2.0 HERE Maps Migration (in the portal):
    • Migrate to HERE maps
    • Implement geofence functionality on map page
    • Implement all map view functionality
  • Key Production Bug Fixes:
    • Fix issue with second callback getting ignored for Profile "Download_Enable" action

09/09/2022 - Release 6.49

  • Global
    • Unified Cloud Router Management application and experience built on top of TS (portal and platform)
    • Support ThingSpace and Business Internet combined user experience in TSM (limited pre-launch access)
    • Provide new API under StateService for AutoShowcase App team to retrieve device information via deviceIdentifier, CBRMDN and EmailAddress
  • Key Production Bug Fixes:
    • SCEF-Callback: reportedTime is incorrect in callbacks delivered to customer

08/24/2022 - Release 6.48

  • Smart FOTA:
    • Support for 10K devices in create campaign
    • Analytics dashboard updates
  • Global
    • Key Production Bug Fixes:
      • License Management Service - resolve getAccountSubscriptionDetails timeout issues
      • TSM/URS: Fix the email link URL for Portal reports in URS
      • Fix Get Device Suspension Status API 

08/09/2022 - Release 6.47

  • Global
    • Incremental development including:
      • Updates on the Dashboard and Router list page
      • Implementation of signal strength test and speed test
      • WiFi Protected Setup management

07/28/2022 - Release 6.46

  • Global
    • Addressed minor Consumer eSIM bugs

07/07/2022 - Release 6.45

  • Consumer eSIM
    • Handle out of order callbacks and complete the callback to customer
    • Validate IMEI for Activation Code callback request
    • Stop retry after 24 hours if no status update and process callback to customer
  • Global
    • Bug fixes for the RTR/IA APIs
    • Remediation of security vulnerabilities via upgrades in multiple services (Fortify, BlackDuck)

06/29/2022 - Release 6.44

  • Global
    • Bug fixes for the RTR/IA APIs
    • Remediation of security vulnerabilities via upgrades in multiple services (Fortify, BlackDuck)

06/15/2022 – Release 6.43

  • Global
    • Consumer eSIM for Enterpise application feature added to new onboarding flow
  • UWS
    • Auto Lite customers restricted to using only the gotostate API in UWS

05/27/2022 – Release 6.42

  • Global
    • Remediation of security vulnerabilities via upgrades in multiple services (Fortify, BlackDuck)

05/13/2022 – Release 6.41

  • Global
    • Fix issue with serviceType field values
    • Remediation of security vulnerabilities via upgrades in multiple services (Fortify, BlackDuck, Pentest, 42 Crunch)
  • ThingSpace Real Time Rating / Intelligent Alerts (RTR/IA)
    • Support for account group share (pooled across ECPDs)
    • Email/SMS includes carrier service plan code in the RatePlan description

04/27/2022 – Release 6.40

  • Global
    • Enable throttle notification service to send Throttle notifications via callback to customers who have subscribed for "SubscriptionNotificationService"
    • Remediation of vulnerabilities via upgrades in multiple services (Fortify, BlackDuck, pentest)

04/13/2022 – Release 6.39

  • Global
    • Services and API changes for feature: Send Subscription throttled status to customer

03/30/2022 – Release 6.38

  • ThingSpace Manage (TSM)
    • Syncing new fields for existing records
    • Send subscription throttled status to customer
  • Bug fixes for
    • Aggregate device's usage scheduled reports returning no data

03/09/2022 – Release 6.37

  • Create, Update, Get V2 Triggers support Provisioning Transaction Alerts
  • Create, Update V2 Triggers support Account Group Share
  • Bug fixes for
    • IMEI being included in SKU based activations
    • EID Device Swap doesn't clear SIM OTA value from old device in Tbl_Devices

02/23/2022 – Release 6.36

  • Added new set of APIs (CreateTriggerV2, UpdateTriggerV2, GetTriggerV2) and enhancements to the PricePlan alerts in the portal application
  • Callback support for Network & Transition alerts
  • Bug fixes for
    • Masking logger for special characters - Fixed Username with special characters appearing in logger

02/09/2022 – Release 6.35

  • ThingSpace Manage (TSM)
    • Include the eUICC profile status in device details page
  • Bug fixes for
    • MDNLess: Promo expiration date timestamp is incorrect

01/31/2022 – Release 6.34

  • MDNless
    • Fix for bill cycle date shows incorrectly when lines are first activated
    • Update PPU fields to empty string if Device is being activated with different appId
    • Added notation on device details page regarding SMS usage and removed empty SMS fields from promo reports
  • Bug Fixes for
    • Updated callback processing error handling when MDN is not released from old device
    • Merged users should now be able to login to TSM even if their default ECPD not onboarded to ThingSpace

01/19/2022 – Release 6.33

  • Bug fixes for
    • MDNLess: On Device Details page, ‘Promo Start Date’ made consistent with ‘Device Activation Date’

12/15/2021 – Release 6.32

  • Bug fixes for
    • MDNless: Fix DataGrid / Database out of sync of promo usage after device moves to  a destination plan

11/17/2021 – Release 6.31

  • eUICC
    • Added MDN, MSISDN and action_by fields to provisioning history items in the callback
  • MDNLess
    • Fix Promo usage not getting updated in DG in some cases
    • Fix Alert saving into DB in edge case of Datetime ending with zeros
  • Bug fixes for
    • Bill cycle end date update at account level
    • Timezone conversion and defaults
    • Removing data for inactive accounts

10/27/21 - release 6.30

08/25/21 - release 6.26

05/26/21 - release 6.20

  • The Retrieve Device Usage History and Retrieve Aggregate Device Usage History APIs were enhanced to return domesticUsage and internationalUsage parameters for RTR customers, when applicable.
  • The GoToState API was enhanced to return four additional parameters in the callback response: subscriptionTypeCode, subscriptionTypeCodeDesc, stageStateChangeReasonCode, and stageStateChangeReasonCodeDesc.
  • The RetrieveDeviceInformation API was enhanced to return a new extended attribute, ServiceStateStartDate for State customers.

02/24/21 - release 6.13

  • All services now support a maximum of 16 digits for the device IMEI.

12/16/20 - release 6.9

11/18/20 - release 6.7

  • The new Send/Receive Non-IP Data Delivery (NIDD) API allows you to send Non-IP data to an NB-IoT device. A subsequent callback allows you to receive non-IP data from an NB-IoT device in an asynchronous callback to the NiddService.
    • For the following APIs, ThingSpace sends another asynchronous NiddService callback message for each NB-IoT device in the request when NIDD Config for the device has been enabled. Example NIDDService callback parameters, and example success and failure callback responses are also included in the documentation for these APIs.
    • The RegisterCallbackListener API  was updated to include the new "NiddService" value for the name parameter in the request body. 
    • The DeregisterCallbackListener API was updated to include the a new "NiddService" value for the sname parameter in the request body. 

09/30/20 CRITICAL UPDATE: Whitelist Additional IP Addresses by October 6, 2020

We are deploying enhancements and transition of our cloud infrastructure. In order for us to keep the transition as seamless as possible and for you to take advantage of the enhancements, it is important for you to whitelist these additional IP addresses by October 6, 2020.

The additional white-listing provides a way for callback messages originating from these new IP addresses to reach you through your firewalls.

NOTE: If you do not whitelist these IP addresses, you wil not be able to receive callbacks!

The 6 new IP addresses are:


However, DO NOT remove the old IP addresses yet, which are:


Whitelist additional IP addresses by August 14, 2020

We are in the middle of enhancing and transitioning our cloud infrastructure. In order for us to keep the transition as seamless as possible and for you to take advantage of the enhancements, it is important for you to whitelist these additional IP addresses by August 14, 2020.

The additional white-listing provides a way for callback messages originating from these new IP addresses to reach you through your firewalls.

The 6 new IP addresses are:


However, DO NOT remove the old IP addresses yet, which are:


Verizon will no longer be supporting TLS 1.0 and TLS 1.1

As of September 1, 2020, the Verizon Media Platform (EdgecastCDN) will no longer support TLS 1.0 and TLS 1.1 protocols. Only TLS 1.2 and TLS 1.3 will be supported.

The way you communicate with our ThingSpace APIs will be impacted and you will not be able to use ThingSpace services unless you upgrade to TLS1.2 or TLS 1.3. Errors that you can expect to receive from our APIs are HTTP status codes in the 2xx class, which indicate the request does not support the HTTP protocol version used.

If this impacts you, please make the appropriate changes to your code to use the supported protocols by September 1, 2020, to avoid disruption of your applications.

Data and SMS Reachability and LTE Network Connection Status

Connectivity management APIs now include API functions to monitor Data and SMS reachability and LTE network connection status of 4G devices. These functions are made available through the Service Capability Exposure Function (SCEF) of the Verizon LTE core network. Monitoring of Data/SMS reachability and connection status of 4G devices provides a significant value add for developing efficient enterprise applications with CAT M and NB IOT devices which are designed to conserve battery power by periodically becoming unreachable for potentially long periods of time and reachable for short “active” durations for transfer of meaningful IOT information such as sensor readings, metering data readings, diagnostic information, etc. These APIs allow a calling application to register for getting callback notifications when the relevant events occur, for a period of up to 10 years. They can also be used in a single query-response mode for an application interested in determining the immediate (now) reachability of a device for Data or SMS communications.

07/29/20 - release 5.28

  • The new Retrieve SMS Event History API 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.

  • The Monitor Device Reachability API was updated to include a MaxUEAvailabilityTime parameter in the callback when the device is in a reachable state. The parameter displays a timestamp (UTC) until which a device using a power-saving mechanism is expected to be reachable for SMS Delivery.

  • The Upload Devices API was updated to make the accountName an optional parameter in the request body. If you have access to only one account, accountName is not required. If you have access to multiple accounts, then the accountName is required.

  • The Deactivate Devices API was updated to include a deleteAfterDeactivation parameter in the request body. Set this parameter to “true” if you want to delete the device from the database after it has been deactivated.

06/03/20 - release 5.26

  • The new RetrieveBilledUsageList API 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.

5/06/20 - release 5.25

  • The new SetUsageSegmentationLabels API allows you to associate your own usage segmentation label with a device.

  • The new RemoveUsageSegmentationLabels API allows you to remove the segmentation label associated with a device.

  • The new RetrieveBilledUsage API allows you to get billing usage for a customer segment for a specified billing cycle, or the most recent billing cycle if one is not specified.

1/09/20 - release 5.21

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

Verizon retired CDMA to 4G

Verizon has retired its CDMA network (1x/EVDO, 2G/3G) to 4G as of December 31, 2019.

  • June 30, 2018 - We stopped activating new CDMA devices.
  • July 1, 2019 - We stopped allowing the following changes for CDMA devices:
    • Device ID change
    • MDN change
    • Price plan change
    • Suspend and Resume

Contact your Verizon account representative for more information.

12/05/19 - release 5.20

  • The new CheckOrderStatus API allows you to check the status of a provisioning order. Initially, only activations were supported.

11/06/19 - release 5.19

  • The new UploadActivate API 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.

7/11/19 - release 5.15

  • The POST /devices/actions/download_enable method has been enhanced to return an eUICC status of EXECUTED_WITHWARNING to identify those instances where a device profile downloaded successfully, but the enable failed. A second callback returning a eUICC status of EXECUTED_SUCCESS will be sent once the device has been enabled.

6/6/19 - release 5.14

  • Use the New POST /devices/actions/upload method to upload devices to the Verizon Device Management Database (DMD). The method returns an asynchronous response containing the list of devices submitted and a line level status for each.

5/28/19 - Cat-M SMS Upgrades

On May 28, 2019, Verizon enhanced the messaging features for Cat-M devices.

If you have deployed Cat-M devices on the Verizon network you are be able to send SMS messages to your distributed assets using any cloud server or device. If you prefer to disable the new feature, reach out to your account representative to discuss the restriction options that are available.

Explore more SMS options in the Quick API reference section.

5/2/19 - release 5.13

  • The POST /devices/actions/activate method has been enhanced to allow for an IP to be set during activation.

4/4/19 - release 5.12

  • The POST /devices/diagnostics/actions/list 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.
  • The PUT /devices/actions/goToState method has been enhanced to convert state names into their 2-digit state code equivalent and will split zip codes into separate zip and zip4 formats in the primaryPlaceOfUse parameter.

3/7/19 - release 5.11

  • The POST /devices/actions/list method has been enhanced to return all active promo codes associated with a device, when searching for a single 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.

2/7/19 - release 5.10

  • The new POST /devices/extendeddiagnostics/actions/list method returns extended diagnostic information about a specified device, including connectivity, provisioning, billing and location status. The /devices/diagnostics/actions/list endpoint is being deprecated.

1/3/19 - release 5.9

  • The POST /devices/diagnostics/actions/list response now includes information about the device firmware version and location, for accounts that are subscribed to those ThingSpace services.
  • The number of possible profile statuses for eUICC devices has been increased to distinguish between newly downloaded profiles and those that have been downloaded and then activated or deactivated. The statuses are in the responses to POST /devices/actions/list requests.

10/3/18 - release 5.6

  • The new POST /devices/diagnostics/actions/list API method returns basic diagnostic information about a specified device, including connectivity, provisioning, and billing status.
  • Customers applying for credit approval from Verizon can now start the device activation process while waiting for the approval. The POST /devices/actions/activate 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.
  • We have replaced a generic error message with more specific error messages for several activation-related issues.

6/28/18 - release 5.4

  • You can use POST /devices/actions/list 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.
  • You can now set a line’s customer name and address (Primary Place of Use) in the PUT /devices/actions/goToState request. The information can be used to contact the customer, if necessary, and the zip code will be used to determine tax jurisdiction.

5/2/18 - release 5.2

New and Updated Resources

  • POST /devices/actions/list A new filter parameter 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.
  • GET /accounts/{accountname}/requests/{requestID}/status Returns the processing status of a single-device asynchronous request.

3/7/18 - release 5.00

New and Updated Resources

  • GET /accounts/{accountname} New request that returns information about the specified account.

2/7/18 - release 4.23

New and Updated Resources

  • An account can now register for the PromoChanges callback to receive callback messages when promotional discounts are removed from devices.
  • POST /devices/actions/list now supports pagination of large result sets and ordering devices in responses by deviceId.
  • The names of the /devices/actions/contactInfo and /devices/actions/goToState endpoints have been changed to camel case.

1/4/18 - release 4.22

New and Updated Resources:

  • Get Device Suspension Status: POST /devices/suspension/status
  • Find Mismatched Hardware: POST /devices/actions/list/imeiiccidmismatch
  • Delete Devices: POST /devices/actions/delete
  • Change Primary Place of Use with PUT /devices/costCenter

Callback Changes

ThingSpace Connectivity Management API now supports these additional callbacks:

  • Resume Tracking Notification - advises when suspended devices will auto-resume to active service
  • External Provisioning Changes - advises when service changes are made in an account through a web portal or other non-API interface
  • Device Suspension Status - asynchronous responses to POST /devices/suspension/status requests
  • Service Plan Changes - asynchronous responses to PUT /devices/actions/plan requests

Additionally, all callback messages now include requestId, status, callbackCount, and maxCallbackTreshold values. Activation and deactivation callbacks now include stateName and serviceName objects. The usageResponse object has been removed from all callbacks except those that report device usage.

12/6/17 - release 4.21

New Resources:

  • Change Device Contact Information: PUT /devices/actions/contactinfo
  • Check if Devices can be Activated: POST /devices/availability/actions/list
  • Move Devices to Another Account: PUT /devices/actions/move
  • Set Devices to Customer-Defined Service and State: PUT /devices/actions/gotostate

New Name and Address Fields

Customer name and address information now includes fields for name suffix, ZIP+4, phone, phone type, and email address.

Updated on 2/12/2016

New Resource: /devices/connections/actions/listHistory

The /devices/connections/actions/list resource has been deprecated and replaced by /devices/connections/actions/listHistory. The “listHistory” resource has the same signature as the original resource, but it will return a 202 status code if there is more data, and the response has been changed from a JSON array to key:value pairs and includes a new hasMoreData parameter.

Updated on 1/15/2016

Consistent Camel Case for URL Paths

The paths for three resources have been changed to camel case capitalization for consistency:

  • /devices/costCenter
  • /devices/actions/customFields
  • /sms/{accountname}/startCallbacks

HTTP Status Code 202 and hasMoreData

Status code 202 for responses is now only used to indicate that the request was successful and there is more information to be retrieved. Those resources that can return a 202 response now also have a hasMoreData Boolean value in the response body.

These response structure for these requests was changed from a JSON array to key:value pairs to accomodate the hasMoreData parameter:

  • GET /sms/{accountname}/history
  • GET /groups/{accountname}/name/{gname}
  • GET /leads/{accountname}

HTTP 204 Responses Replaced with 200 and success=true

These requests that used to return an empty response for success (status code 204) have been changed to return status code 200, with a response body parameter of “success”: true.

  • POST /groups
  • PUT /groups/{accountname}/name/{gname}
  • DELETE /groups/{accountname}/name/{gname}
  • PUT /sms/{accountname}/startCallbacks