Release Notes

Beginning March 1, 2023, the Bandwidth Dashboard API will no longer guarantee that the HTTP reason phrase will be sent on responses to API requests. This is in accordance with the HTTP standard (RFC 9110, Section 15.1).

This change means that a response that used to look like this:

GET https://dashboard.bandwidth.com/api/tns?npa=919

HTTP/1.1 200 OK

Will now return this:

GET https://dashboard.bandwidth.com/api/tns?npa=919

HTTP/1.1 200 

Please verify that your apps do not use the reason phrase when processing responses from our API in advance of March 1.

Beginning January 11, 2023, we are offering Global Number Hosting for geographic, national and toll-free numbers in France. This service will allow you to provision numbers on the Bandwidth network that you have obtained from ARCEP, the French regulator. When hosting your own numbers, you will be able to leverage our interconnected network and robust number management experience while maintaining ownership of the number in accordance with local regulations. 

For more information, check out our FAQ. To contract for Global Number Hosting, reach out to your account manager.

In order to improve security and reliability, we are limiting the types of file uploads we support for both port-in documents and import TN documents. We are also adding validation to ensure that the content-type header, the file type extension, and the MIME-type are consistent with each other.

Effective March 2, 2023, Bandwidth will allow only the following types of files to be uploaded:

• CSV (“text/csv”)
• DOC (“application/msword”)
• DOCX (“application/vnd.openxmlformats-officedocument.wordprocessingml.document”)
• JPG/JPEG (“image/jpeg”)
• PDF (“application/pdf”)
• PNG (“image/png”)
• TXT (“text/plain”)
• TIFF (“image/tiff”)
• XLS (“application/vnd.ms-excel”)
• XLSX (“application/vnd.openxmlformats-officedocument.spreadsheetml.sheet”)

If you have any questions regarding this upcoming change, reach out to your Bandwidth Support Team!

On January 6, 2023, we will perform a messaging release that may cause changes to the letter case of HTTP headers within HTTP responses and callbacks. For instance, the “Content-Type” header may be changed to “content-type.”

Please validate that your applications are parsing these headers in a case-insensitive fashion in accordance with RFC 9110.

Beginning November 30, 2022, Bandwidth is offering global customers the ability to search and order specific numbers or consecutive number ranges using the Global Portal API. Numbers can be held in the customer’s cart for a maximum of 10 minutes. For more information, view our API docs.

As of November 14, 2022, IP Traffic Consolidation now allows for the dynamic handling of emergency call routing types, allowing customers to send any route type (static VoIP, PIDF-LO, lat-lon (X/Y), and Microsoft Teams) down any SIP trunk associated with opted-in accounts.

To enable IP Traffic Consolidation, contact your account manager.

Three new messaging error codes are being created and will take effect by September 30, 2022:

• volumetric-violation
  • SMPP/MM4: 785 
  • API: 4785
• tfn-not-verified 
  • SMPP/MM4: 795 
  • API: 4795
• media-content-invalid 
  • SMPP/MM4: 712 
  • API: 4712

Please review our full list of SMPP SMS Delivery Receipts and Error Codes and Messaging API HTTP Error Codes for more details.

Beginning August 2, 2022, Bandwidth is enhancing the emergency notification provisioning capabilities to allow customers to manage notification recipients within the US & Canada Portal. This update allows customers to add, edit, and delete single notification recipients or create a group of up to three recipients associated with one or multiple endpoints, all within the portal. 

Please reach out to your account manager if you would like this feature added to your account.”

For more information, please view our Support Center guide.

Effective June 27, 2022, Bandwidth will support 988 as the number for the National Suicide Prevention Lifeline. 

Customers may need to adjust their dial plan to support 988 in order to comply with FCC rules to establish 988 as the nationwide 3-digit dialing code for Americans in crisis by July 16, 2022. 

For more information, view our 988 dialing announcement.

Three messaging error codes are being updated on July 6, 2022:

• volume-violation-tmo
  • SMPP: 780
  • API: 4780
• volume-violation-att
  • SMPP: 781
  • API: 4781
• rejected-shortened-url
  • SMPP: 771
  • API: 4771

Please review our full list of SMPP SMS Delivery Receipts and Error Codes and Messaging API HTTP Error Codes for more details.

Effective July 1, 2022, a tone detection enhancement to our Answering Machine Detection (AMD) feature will be available. This will enable the application to detect answering machine tones, thus allowing the application to better time when to leave a message. 

This will be enabled for all accounts on October 1, 2022. Customers can contact their account manager or customer service manager if they would like it to be enabled before October 1. There is no additional charge for tone detection.

The tone detection addition will indicate a tone by returning a new machineDetectionResult value of “tone-detected” in machineDetectionComplete webhook. This value will only be returned if Answering Machine Detection is invoked with delayResult set to true.

We have introduced a new call modification endpoint that makes it easier for customers to pass BXML on an active call by directly calling the new API endpoint with the new BXML.

For more information, check out our API docs on how to Modify Calls with BXML or our guide on how to Modify Calls in Progress.

Starting June 23, 2022, Bandwidth is offering customers the ability to view telephone numbers prior to purchase through an advanced search in the Global Portal API. For more information, view our API docs.

Beginning July 15, 2022, Bandwidth is requiring Voxbone Portal users to explicitly select user privileges within sub-accounts to continue API accessIn order for sub-accounts to be able to continue making API calls to these endpoints, users will need to have the following privileges set via the Voxbone Portal:

/configuration  – “Configuration” privilege required

/regulation – “Regulation” privilege required

/inventory  – “Ordering” or “Configuration” privilege required

/ordering – “Ordering” privilege required

Bandwidth is enabling Outbound Call Queueing for Voice API customers on April 30, 2022.

Before, if customers exceeded their calls per second (CPS) rate, any calls over that limit were rejected. Instead of rejecting those calls, Outbound Call Queueing places them into a queue to be completed based on the customer’s CPS limits.

The number of TNs that can be associated with a single 10DLC Campaign is now limited to 49, unless the customer has been approved for a Sub ID. The limit of 49 TNs is consistent with T-Mobile’s policy. Customers will receive an error message when adding 50 or greater TNs.

Effective February 23, 2022, failover/ final destination URIs will be added as a Bandwidth Dashboard functionality. These URIs allow calls to be sent to a backup route in the event that the usual call route fails. Learn more here.

Beginning February 7, 2022, we’re updating message search API so that users receive 429 error codes when rate limits are exceeded.

Beginning February 15, 2022, we’re removing a few of the previously accepted file types for MMS. We’ll continue to accept all file types on this list.

Keep in mind that downstream carriers may have additional limitations that can affect deliverability. Jpeg, png, and gif images continue to be the most widely supported amongst carriers.

Customers needing to apply for a sub-id to support registering greater than 49 TNs per campaign are now able to do so. Click here for more information. 

Registration of Sole Proprietor campaigns and brands is now available via the Bandwidth Dashboard Portal and API.