Query delivery records
After you send a message, you can query the message sending details in the Short Message Service console or by using the API.
Usage
Delivery records support queries over any custom time range. The detailed query supports records from the past 90 days, and each query is limited to a 30-day time range. To query a longer range, use the export feature. The
QuerySendDetailsAPI returns delivery records only from the past 30 days. Delivery record details are retained for 3 years. Records outside the supported query time range cannot be recovered, so export important records in a timely manner.The delivery records displayed on the page and the data in Excel exports come from the same data source. Fields such as send time, receive time, delivery status, status code, and billable message count are aligned one-to-one with the same precision across both views, which helps you avoid discrepancies during reconciliation.
Procedure
Log on to the Short Message Service console.
In the left-side navigation pane, choose .
On the Query Messaging Records tab, set the filter criteria based on your query needs.
Click Search to view matching records.
Send time: The time the message was sent.
Receive time: The time the recipient received the message.
The page displays up to 5,000 query results.
Optional: Export delivery records.
Click Export. In the Export Messaging Records dialog box, filter the records by criteria such as send time, signature, and template. A single export supports a time range of up to 31 days; if the range exceeds 31 days, you cannot submit the export request. The template type and template are optional filter criteria. If you do not select a template, all template records are exported.
The field values are consistent with those displayed in the delivery records list.
Click OK to submit the export request. The request status changes to Pending Approval, and you can export the records only after the request is approved.
To query delivery records older than 31 days, go to Business Statistics > Send Statistics in the Short Message Service console. This page lets you filter by template name and supports a custom date range of up to 366 days.
On the Export Messaging Records tab, filter requests by approval status and click Export in the Actions column to download the requested records.
Sensitive information protection
The delivery records query page provides a Sensitive Information Protection switch. When this switch is turned on, phone numbers and message content are displayed in a masked format.
To turn off Sensitive Information Protection:
Click the Sensitive Information Protection switch.
A confirmation dialog box appears with the following message: "If you disable this feature, phone numbers and content will be displayed in plaintext, and export will also display in plaintext. Please proceed with caution!"
Click Disable to confirm, or click Cancel to abort.
After you turn off Sensitive Information Protection, phone numbers and message content are displayed in plaintext in the query results, and exported records are also displayed in plaintext.
FAQ
Why are asterisks (*) displayed in delivery records in the console?
Why do the delivery records shown in the console not match the actual number of messages sent?
If a sent message is not delivered, will I receive a delivery receipt indicating the failure?
Why is a message not received even though it was successfully sent?
Why did the export of today's delivery records fail?
Exporting delivery records for the current day is subject to a quantity limit. A single export for the current day supports up to 100,000 messages (counted by billable message count for long SMS messages). If this limit is exceeded, wait until after 9:00 AM the next day and use the Export Messaging Records tab to export historical data instead.