V2 Messaging API Features Guide


Jason Sommerset


V2 APIs for Messaging

Bandwidth has launched its new V2 Messaging APIs for Messaging! These APIs provide the same basic functionality for SMS and MMS that our V1 Messaging APIs provided, but with added messaging features and full integration into Bandwidth’s primary portal, dashboard.bandwidth.com. This allows for simpler, easier use alongside Bandwidth’s advanced number management, voice, and 911 services.


We’re launching new features for V2 Messaging APIs!



Group Messaging (MMS)

Ability to send and receive text messages involving multiple recipients using long code phone numbers.

Segment Count

Available in callbacks

Downloadable MDR CSVs


Long Code A2P Support

Currently in Limited Availability. Contact Sales for more information.

Toll Free MMS Support

Currently in Limited Availability. Contact Sales for more information.

SMS Burst Traffic

Provides a default queue and can accept high bursts. Rate Limit Errors occur when average volumes exceed a 15 min queue.

Application Management

The Bandwidth Dashboard


Per Message Segment (Industry standard)


Enhanced features in V2 Messaging API (Enhancements over V1 API)  



Use one Dashboard for all your Bandwidth needs - manage numbers and APIs seamlessly

Account Management

The Bandwidth Dashboard

Buying Numbers

The Bandwidth Dashboard only - no need to import numbers into the Application Platform!

Disconnecting Numbers

The Bandwidth Dashboard

Porting Numbers

The Bandwidth Dashboard

API Token Management

The Bandwidth Dashboard


Messaging APIs

DLRs / Error Codes

Expansion from 18 DLR codes to 40+ DLR codes to improve the understanding of undelivered messages. See  V2 Error Codes

Callback Data Formats

Message callbacks are sent as an array of objects for every event

Callback Retry Logic

Callback failures are automatically retried every few minutes  for up to 24 hours in event of a network or server failure. Additionally, the priority of sending callbacks is optimized so that callbacks that have never retried are the ones being sent first, followed by callbacks that have already been retried.

HTTP Response Codes

Faster, steadier responses with asynchronous processing, returns HTTP Response code ‘202- Accepted’, and will automatically send a callback for every event freeing up resources faster for high scalability between customers' servers and Bandwidth’s APIs


Throughput / Delivery


On by Default

Queue Size

15 Minutes

Burst Limits

Can accept higher bursts, up to your De-Queue Rate Limit

Rate Limits determined by

De-Queue Message Segment Per Second  (industry standard)

Error Codes for Rate Limits

HTTP 429


International Support

Full International Reach

Supports all 5 zones - see Messaging Reach List

Support non-English characters

Enhanced Support that is supported across carriers (GSM-7 and UCS-2 Encoding)


Reports / MDR

MDR Content

Detailed - see MDR field descriptions


Message & Content Storage

Store Message content

Message content is not stored


Article is closed for comments.