V2 Messaging API features guide


Jason Sommerset


These APIs provide the same basic functionality for SMS and MMS as our V1 Messaging APIs, but with the added messaging features and full integration into the Bandwidth Dashboard! This allows for simpler and easier use alongside our advanced number management, voice, and 911 services.



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. Please reach out to your Account Manager for more information.

Toll Free MMS Support

Currently in Limited Availability. Please reach out to your Account Manager 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

Feature Description

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 - please see out Messaging Carrier Reach list.

Support non-English characters

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


MDR content

Detailed - please see MDR field descriptions

 Message and Content Storage

Store Message content

Message content isn't stored

Article is closed for comments.