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

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

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

1Host: https://YOUR_SUBDOMAIN.rest.marketingcloudapis.com
2GET /sms/v1/messageList/MESSAGE_ID/deliveries/TOKEN_ID
3Content-Type: application/json
4Authorization: Bearer YOUR_ACCESS_TOKEN

The response contains information about the specified send.

1{
2  "message": "Test Delivery Receipt",
3  "count": 1,
4  "createDate": "2013-04-25T15:01:04.147",
5  "completeDate": "2013-04-25T15:01:55.197",
6  "status": "Finished",
7  "tracking": [
8    {
9      "mobileNumber": "15555555510",
10      "statusCode": "20",
11      "message": "NA"
12    }
13  ]
14}

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.

1{
2  "errors" : ["Message id cI217sdksi3 is not valid."]
3}