You can specify a Message Service (MNS) queue or an HTTP URL to receive SMS delivery reports. Then, call the SmsReport operation to pull SMS delivery reports from the MNS queue or HTTP server.

Note For information about how to specify a queue or an HTTP URL, see Consumption modes of SMS delivery reports.

Push messages from regions outside mainland China to regions outside mainland China

Request parameters

Parameter Type Description Example
To String The mobile phone number of the recipient. 159****5678
Status String Transmission Status The status that indicates whether the message was sent.
  • 1: The message was sent.
  • 2: The message failed to be sent.
  • 6: The message 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 SMS delivery receipt was received from the carrier. 2020-05-01 10:00:03
ErrorCode String The error code. UNKNOW
ErrorDescription String The error message. An unknown error occurred.
Sample request
[
  {
    "To" : "159****5678",
    "SendDate" : "2017-01-01 00:00:00",
    "ReceiveDate" : "2017-01-01 00:00:00",
    "Status" : "2",
    "ErrorCode" : "UNKNOW",
    "ErrorMessage": "An unknown error occurred.",
    "TaskId" : "67890"
    "MessageId" : "123456789"
  }
]

Push messages from regions outside mainland China to mainland China

Request parameters

Parameter Type Description Example
PhoneNumber String The mobile phone number of the recipient. 159****5678
SendStatus String Transmission Status The status that indicates whether the message was sent.
  • 1: The message was sent.
  • 2: The message failed to be sent.
  • 6: The message 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 API 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 SMS delivery receipt was received from the carrier. 2020-05-01 10:00:03
ErrorCode String The error code. UNKNOW
ErrorMessage String The error message. An unknown error occurred.
SmsQuantity String Each message must be 1 to 140 bytes in length. If a message exceeds 140 bytes, it is separated into multiple messages. 1, 2, 3
Sample request
[
  {
    "PhoneNumber" : "1390****001",
    "SendDate" : "2017-01-01 00:00:00",
    "ReceiveDate" : "2017-01-01 00:00:00",
    "SendStatus" : "2",
    "ErrorCode" : "UNKNOW",
    "ErrorMessage": "An unknown error occurred.",
    "SmsQuantity" : "1,2,3",
    "BizId" : "1234567^0",
    "ExternalId" : "67890"
  }
]