Telegram Delivery Report REST API
Telegram Delivery Report REST API for SMSGatewayCenter APIs
Telegram Delivery Report (DLR) REST API
Use the Delivery Report REST API to fetch Telegram message delivery reports for your account over HTTP. Reconcile sends, track delivery status, and integrate with billing or analytics systems. This endpoint accepts GET requests and returns JSON.
API Endpoint
https://unify.smsgateway.center/rest/tg/v1/dlrLegacy alias without v1 in the path is also supported: /rest/tg/dlr
Authentication
Send your account userid and password as request parameters. Telegram Chat API access must be enabled on your account.
| Parameter | Required | Description | Example/Value |
|---|---|---|---|
| Authentication (Required) | |||
| userid | Yes | Your SMSGatewayCenter account username. | YourUsername |
| password | Yes | Your account password. | ********** |
| output | Yes | Response format. Must be json. | json |
| Optional Parameters | |||
| action | Optional | Defaults to list. Only list is supported in v1. | list |
| fromDate | Optional | Start of submit date range. Format YYYY-MM-DD or full date/time. Alias: from. | 2026-07-01 00:00:00 |
| toDate | Optional | End of submit date range. Format YYYY-MM-DD or full date/time. Alias: to. | 2026-07-07 23:59:59 |
| chatId | Optional | Filter by Telegram chat ID (numeric). | 536510855 |
| uuId | Optional | Filter by transaction ID returned when the message was sent. Alias: transactionId. | 1234567890123456789 |
| uniqueId | Optional | Filter by internal unique message ID. | 90001 |
| msgId | Optional | Filter by Telegram message ID. | 42 |
| msgType | Optional | Filter by message type (example: text, photo, document). | text |
| channel | Optional | Filter by send channel: 1 API, 2 UI, 3 Agent. | 1 |
| status | Optional | Filter by delivery status: 0 delivered, 1 failed. Alias: globalErrorCode. | 0 |
| phoneNumber | Optional | Filter by customer phone number with country code, digits only. Matches contacts who shared their phone with your bot. | 919999999999 |
| page | Optional | Page number. Default 1. | 1 |
| limit | Optional | Records per page. Default 50, maximum 200. | 50 |
Sample Request Code (cURL)
curl --location 'https://unify.smsgateway.center/rest/tg/v1/dlr?userid=YourUsername&password=xxxxx&output=json&action=list&fromDate=2026-06-30&toDate=2026-07-07&chatId=536510855&status=0&channel=1&page=1&limit=50'
Sample Success Response
{
"status": "success",
"dlrList": [
{
"logId": "501",
"uniqueId": "90001",
"uuId": "1234567890123456789",
"transactionId": "1234567890123456789",
"chatId": "123456789",
"phoneNumber": "919999999999",
"msgId": "42",
"message": "Your order is confirmed.",
"msgType": "text",
"charges": "0.50",
"sendMethod": 1,
"globalErrorCode": 0,
"deliveryStatus": "delivered",
"vendorErrorCode": "",
"channel": 1,
"channelName": "API",
"isFinal": 1,
"submitTime": 1712345678901,
"submitTimeFormatted": "2026-07-07 10:14:38",
"dispatchedTime": 1712345680000,
"deliveryTime": 1712345681000,
"deliveryTimeFormatted": "2026-07-07 10:14:41"
}
],
"totalRecords": 1,
"page": 1,
"limit": 50,
"fromDate": "2026-07-01 00:00:00",
"toDate": "2026-07-07 23:59:59",
"statusCode": "200",
"reason": "success"
}
Sample Error Response
{
"status": "error",
"dlrList": [],
"statusCode": "403",
"reason": "Telegram API access is not enabled for this account."
}
Notes
- Results are ordered by
submitTimedescending (newest first). uuIdandtransactionIdare the same value returned when you send a message via the Send Telegram Message API.deliveryStatusis a readable label derived fromglobalErrorCode(0= delivered,1= failed).phoneNumberin the response comes from customer mapping when the contact shared their phone with your bot.
Testimonials
Why do Great Businesses Trust SMS Gateway Center?
