GET /sms/v1/messageList/{id}/deliveries/{tokenId}

Returns status for a message sent to a group of mobile numbers.

NameTypeDescription
messageIdStringMessage Id provided for the messageList
tokenIdStringToken Id returned for the messageList

This sample request shows how to retrieve the status of an SMS send.

The response contains information about the specified send.

The response includes this information about the send:

message

The message text sent in the SMS message

count

The total number of mobile numbers included in the send request subtracting the number of unsubscribed recipients

createdDate

Date when the MessageContact send was submitted, returned in CST

createdDate

Date when the send completed, returned in CST

status

The status of the send. Possible values:

  • Finished
  • Error
  • New
  • Queuing
  • Started

If the request includes an invalid messageId or tokenId, the API returns an HTTP 400 response that describes the error.

MessageDetails
Message id {0} isn’t valid.The messageID value provided in the URL wasn’t in a valid format.
”Token id {0} isn’t valid.”The tokenId value provided in the URL wasn’t in a valid format.
Token id {0} isn’t valid for this client.The tokenId value provided is valid but was created for another client.
TokenId {0} isn’t valid for MessageId {1}.The tokenId value provided is valid for your account but not for the MessageId provided.
An unexpected error occurred, please contact Customer Support with reference id {0}.If this unexpected error is presented when making a call, please take note of the reference id value returned in the error and contact ExactTarget Global Support for more information.