How do I use Message Logs?

Our Message Logs feature allows you to access information about the status of your messages in real time and see what’s happening to them at Bandwidth before the delivery information is received. This feature also lets you follow the flow of the message while it’s being sent.

Accessing Message Logs

1. Log into the Bandwidth Dashboard.
2. In the top navigation bar, select Insights and click Messaging.
3. Select Message Logs.

Note: If you’re unable to view this page, please ensure that you have Messaging Insights permissions enabled.

4. From here you may refine your search for Message Logs using the following parameters:
   • From Date
   • To Date
   • From Number 
   • To Number
   • Status
   • Error Code
   • Message Type
   • Message ID
   • Carrier
   • Direction

Note: Your results will include records from the past 30 days and a maximum of 10,000 records without filtering. Please use the search filters to refine the results. 

What information is available in Messaging Logs?

You may be familiar with these fields from other reporting you use at Bandwidth. An explanation for each field is listed below for your convenience. 

• Message ID: The unique ID associated with the message.
• Date/Time (UTC): In Coordinated Universal Time (UTC), this is the date and time the message was received by Bandwidth.
  • Note: You can search within at least the last 30 days.
• Type: Indicates whether the message is SMS or MMS.
• Direction: Indicates whether the message is inbound or outbound.
• From: This phone number is the sender.
• To: This phone number is the receiver.
• Status: This is the current status of the message, which is derived from the event status as the message is processed. For more information, please see the list of message statuses below.
• Error: This is the 4-digit messaging error code associated with the message. For more information, please see the complete list of messaging error codes.
• Carrier: This is the name of the carrier, either originating carrier or destination carrier depending on the direction of the message.
• Campaign Class: The campaign class of the message, or unregistered. Only applies to A2P traffic where campaigns have been registered.
• Segment Count: SMS messages that exceed the character limitation for their given encoding are broken into multiple parts in order to be sent or received. This is the total quantity of parts your message was broken into. 

How status in Message Logs works

Message Logs show the real-time status of the message. This diagram shows the multiple statuses a message goes through as it is being sent through Bandwidth to its intended destination. 

Understanding error codes

The Error field indicates the messaging error for each message. If the message was successful, it will display a 0. If not, it will display a 4-digit error code once the message is in a final delivery status. See the full list of messaging errors for the description and explanation of each error. 

Note: If you send messages using SMPP and/or MM4, you may be more familiar with 3-digit SMPP and MM4 codes. The error codes you’re able to search by in Message Logs are very similar: they have a leading digit that indicates whether the error is a client (customer) or service error.

Understanding segment count

The Segment Count field indicates the number of segments the original SMS message from the user is broken into before it's sent over the carrier networks. Because the number of supported characters in an SMS message is limited based on the encoding used, the message that exceeds that limit will be broken into multiple parts. See our character limitations and concatenation practices to learn more about why your messages may have multiple segments.