Alibaba Cloud Short Message Service (SMS) pushes message delivery reports to a specified message queue. To view the queue name, log on to the SMS console. You can call this operation to pull the message delivery reports from the message queue.

Request parameters

Note Users can specify message service (MNS) queues or HTTP URLs to receive SMS sending status reports pushed by SMS. The SmsReport is then called to pull the messaging report from the specified message queue or HTTP server. You must specify the following parameters when calling this operation:

For more information about how to specify an MNS queue or HTTP URL, see message receiving mode.

If SMS messages are sent from regions outside mainland China to mainland China, specify the following parameters when you call this operation.
Parameter Type Decription Example
PhoneNumber String The mobile number of the recipient. 159 consecutive minutes * 5678
SendStatus String The delivery status of the message. The sending status of the SMS message:
  • 1 Deliverd
  • 2 Failed
  • 6 Expired
BizId String The ID of the delivery receipt. 1234567 ^ 0
ExternalId String The ID of the batch. Set this parameter to the value of the outId parameter that is specified when you call an operation to send messages. 123456
SendDate String The time when the message was sent. 2020-05-01 10:00:00
ReceiveDate String The time when the delivery receipt was received from the carrier. 2020-05-01 10:00:03
ErrorCode String Error codes UNKNOW
ErrorMessage String The error message. An unknown error has occurred.
SmsQuantity String The number of messages. Each message can be up to 140 bytes in length. If a message is longer than 140 bytes, SMS separates the message into multiple messages. 1, 2, 3
If SMS messages are sent from mainland China to regions outside mainland China, specify the following parameters when you call this operation.
Parameter Type Decription Example
To String The mobile number of the recipient. 159 consecutive minutes * 5678
Status String The delivery status of the message. The sending status of the SMS message:
  • 1 Deliverd
  • 2 Failed
  • 6 Expired
MessageId String The ID of the delivery receipt. 123456789
TaskId String The ID of the batch. Set this parameter to the value of the taskId parameter that is specified when you call an operation to send messages. 123456
SendDate String The time when the message was sent. 2020-05-01 10:00:00
ReceiveDate String The time when the delivery receipt was received from the carrier. 2020-05-01 10:00:03
ErrorCode String Error codes UNKNOW
ErrorDescription String The error message. An unknown error has occurred.

Examples

Sample requests
[
  {
    "PhoneNumber" : "1390****001",
    "SendDate" : "2017-01-01 00:00:00",
    "ReceiveDate" : "2017-01-01 00:00:00",
    "SendStatus" : "1",
    "ErrorCode" : "UNKNOW",
    "ErrorMessage" : "An unknown error has occurred.",
    "SmsQuantity" : "1,2,3",
    "BizId" : "1234567^0",
    "ExternalId" : "67890"
  }
]
Sample success responses

{
  "code" : 0,
  "msg" : "The message is received."
}