What is an SMS MDR?

For every sent or received message, an MDR (message detail record) will be written. You can access your report under 'REPORTING' in Mission Control.

MDRs are stored as JSON objects. These are the most important fields contained in each MDR:

The embedded body object contains the following fields:

For privacy reasons, a message’s text is only stored for up to 7 days before it is wiped. At that point, the hash fields can be used to identify messages.


For sent messages, the possible status values are:

For received messages, the possible status values are:

The delivery_status field is used to give further details about the delivery confirmation (outbound) or delivery attempt (inbound).

Message coding

The coding field is an integer representing the message’s encoding. It will typically have one of the following values:

When you send messages, the encoding is determined on the basis of the characters in the message body. If possible, GSM 7-bit is used; otherwise, UTF-16 is used.

Message parts

Long messages must be divided into parts for transmission. The size of each part depends on the encoding.

For outbound messages, there is a maximum message size of 5 parts.

Please note that billing and rate limiting are applied based on the number of parts.

Can't find what you're looking for? Click the chat bubble at your lower right hand corner and start a chat!

Did this answer your question?