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. Thu, 25 Nov 2021 10:27:00 +080
ReceiveDate String The time when the SMS delivery receipt was received from the carrier. Thu, 25 Nov 2021 10:27:33 +080
ErrorCode String The error code. success
ErrorDescription String The error message. success
Sample request
[
  {
    "To" : "159****5678",
    "SendDate" : "Thu, 25 Nov 2021 10:27:00 +080",
    "ReceiveDate" : "Thu, 25 Nov 2021 10:27:33 +080",
    "Status" : "1",
    "ErrorCode" : "success",
    "ErrorMessage": "success",
    "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. Thu, 25 Nov 2021 10:27:00 +080
ReceiveDate String The time when the SMS delivery receipt was received from the carrier. Thu, 25 Nov 2021 10:27:33 +080
ErrorCode String The error code. success
ErrorMessage String The error message. success
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
Sample request
[
  {
    "PhoneNumber" : "1390****001",
    "SendDate" : "Thu, 25 Nov 2021 10:27:00 +080",
    "ReceiveDate" : "Thu, 25 Nov 2021 10:27:33 +080",
    "SendStatus" : "1",
    "ErrorCode" : "success",
    "ErrorMessage": "success",
    "SmsQuantity" : "1",
    "BizId" : "1234567^0****",
    "ExternalId" : "67890"
  }
]