On occasion, you may want to query our APIs for data on a previous send or specific mobile number. In this article, you’ll learn how to gain meta information using URL calls.

Skip to a specific section:

Retrieve All Available Info

Using this GET method, you can retrieve information about previous messages you’ve sent to a handset, which you can use for informational purposes or to troubleshoot a specific issue.

To perform this call, you’ll need the specific messageID for the message you’d like information on. The messageID is returned when you successfully submit a message.

📘

Asynchronous processing

Our system processes asynchronously, meaning your message is not guaranteed to be available and retrievable until after the response callback has been made. Additionally, this call should be used only to retrieve a specific message for informational purposes.

🚧

Do not use for data retrieval

This API should not be used for mass message data retrieval. If information is needed on multiple MT message status, please see our Callbacks article.

Request

Below is an example of the URL request for this information.

https://messageapi.vibesapps.com/MessageApi/mt/messages/b75fccf3-8f06-4d8f-a282-d1886a4792a2

Response

Below is an example of the response you might get to the above request. The relevant elements are defined below.

<mtMessage submitterMessageId="239487234987234"
    messageId="b75fccf3-8f06-4d8f-a282-d1886a4792a2" 
    submitDate="2011-04-19T15:10:08.320-05:00" isMultipart="true" noOfParts="2" partNumber="1" originalMessageId="b75fccf3-8f06-4d8f-a282-d1886a4792a2">
    <destination carrier="102" address="+12995551234" type="MDN" />
    <source address="98765" type="SC" />
    <text>123857AB12</text>
    <receiptOption>ERROR</receiptOption>
</mtMessage>

mtMessage is the main wrapper element for the response to this response. The attributes are displayed in a table below. For more information about the other elements and attributes not defined here, see our article on sending an SMS message

Attribute NameDescriptionData Type
fwdToMessageIdIf the original send utilized alternate message delivery (available for v3.1+ only), this attribute may appear in your response. The value will be the unique message ID of the alternate message that was sent when the original message failed.
fwdFromMessageIdIf your send utilized alternate message delivery (available for v3.1+ only) and the message you requested information on was not the original message, this attribute may appear in your response. The value will be the unique message ID of the original message that was attempted and failed.
isMultipartOnly present if equal to True, which indicates the message was split into multiple parts.Boolean
noOfPartsOnly present if isMultipart=”true”. This string indicates the number of parts the message was split into.String
partNumberOnly present if isMultipart=”true”. This string indicates the number of this message’s part.String
originalMessageIdOnly present if isMultipart=”true”. This string indicates the messageId for the original message that was split.String

Reference Table

The reference tables below contain the same information as above, but in a quick-reference table form.

ElementAttributeDescriptionData Type
mtMessageThe main wrapper element around the submit response.
fwdToMessageIdIf the original send utilized alternate message delivery (available for v3.1+ only), this attribute may appear in your response. The value will be the unique message ID of the alternate message that was sent when the original message failed.
fwdFromMessageIdIf your send utilized alternate message delivery (available for v3.1+ only) and the message you requested information on was not the original message, this attribute may appear in your response. The value will be the unique message ID of the original message that was attempted and failed.
isMultipartOnly present if equal to True. True if this message is part of a multi-part message.Boolean
noOfPartsOnly present if isMultipart=true. This string indicates the number of parts the message was split into.String
partNumberOnly present if isMultipart=true. This string indicates the number of this message’s part.String
originalMessageIdOnly present if isMultipart=true. This string indicates the messageId for the original message that was split.String
mtMessageResponsesThe wrapper element that has all the MTMESSAGERESPONSES for the MT message.
mtMessageResponseThe root element of a MTMESSAGERESPONSE.
messageIdThe unique identifier assigned to the message when it was submitted.String
submitterMessageIdThe client-defined identifier for the message if set while submitting the message.String
fwdToMessageIdIf the original send utilized alternate message delivery (available for v3.1+ only), this attribute may appear in your response. The value will be the unique message ID of the alternate message that was sent when the original message failed.
fwdFromMessageIdIf your send utilized alternate message delivery (available for v3.1+ only) and the message you requested information on was not the original message, this attribute may appear in your response. The value will be the unique message ID of the original message that was attempted and failed.
receiptDateDate the response was received in standard XML format.String
typeThe processing stage at which the response was generated. The possible values are as follows:

- System: While the MTMESSAGE was being routed to the carrier by the Message API system.
- Carrier: While submitting the MTMESSAGE to the carrier.
- Handset: While submitting the MTMESSAGE to the handset.
String
statusElement that has the status of the MTMESSAGE.
isErrorBoolean on whether the status is an error.Boolean
descriptionThis element provides a description of the error if an error is present. If no error is present, it will read MtMessage successfully delivered to Carrier.String
errorCodeIf the message fails, this element contains the error code that describes the specific failure reason.

See HTTP Error and Status Codes for more info.
Numeric
internalErrorCodeIf the message fails due to a Vibes error, this element contains the exact same value as the errorcode element.

If the message fails due to a carrier error, this element contains the exact error code returned by the carrier to Vibes for further research. This value can be communicated to Vibes support for more information.
Numeric
multipartThe wrapper element that has all information about MULTIPART (long message split into multiple parts) message.

This element is present if the request had SPLITLONGMESSAGE set to True, and the original Long message got split into multiple parts.
isMultipartIf the original message was multipart, this will be set to true.Boolean
noOfPartsOnly present if isMultipart=true. This string indicates the number of parts the message was split into.String
partNumberOnly present if isMultipart=true. This string indicates the number of this message’s part.String
originalMessageIdOnly present if isMultipart=true. This string indicates the messageId for the original message that was split.
Language
Click Try It! to start a request and see the response here!