RCS Delivery Report REST API
RCS Delivery Report REST API for SMSGatewayCenter APIs
RCS Delivery Report (DLR) REST API
Use the Delivery Report REST API to fetch RCS message delivery reports for your account over HTTP. Filter by date, mobile, bot, campaign, template, or transaction id. This endpoint accepts GET requests and returns JSON.
API Endpoint
https://unify.smsgateway.center/rest/rcs/v1/dlrLegacy alias without v1 in the path is also supported: /rest/rcs/dlr
Authentication
Send your account userid with either password as a request parameter, or your account API key in the apikey request header. userid is required in both cases. Password is not required when the apikey header is used. RCS product and RCS API access must be enabled on your account. Do not publish live usernames or passwords.
| Parameter | Required | Description | Example/Value |
|---|---|---|---|
| Authentication | |||
| userid | Yes | Your SMSGatewayCenter account username. Required even when the apikey header is used. | YourUsername |
| password | Yes* | Your account password. Not required when the apikey header is used. | ********** |
| 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-14 |
| toDate | Optional | End of submit date range. Format YYYY-MM-DD or full date/time. Alias: to. | 2026-07-14 |
| mobileNo | Optional | Filter by recipient mobile number with country code, digits only. | 919876543210 |
| uuId | Optional | Filter by platform unique id. Alias: transactionId. | 17324567890 |
| botId | Optional | Filter by numeric RCS bot id. | 3 |
| campaignName | Optional | Filter by campaign name. | api_campaign_001 |
| templateName | Optional | Filter by template name. | WELCOME_TEMPLATE |
| globalErrorCode | Optional | Filter by delivery status code. Alias: status. | 0 |
| globalErrorCodes | Optional | Comma-separated status codes. | 0,2 |
| page | Optional | Page number. Default 1. | 1 |
| limit | Optional | Records per page. Default 50, maximum 200. | 50 |
Sample Request (cURL)
curl --location 'https://unify.smsgateway.center/rest/rcs/v1/dlr?userid=YourUsername&password=xxxxx&output=json&action=list&fromDate=2026-07-14&toDate=2026-07-14&page=1&limit=50'
Sample Request - API Key Header (cURL)
curl --location --get 'https://unify.smsgateway.center/rest/rcs/v1/dlr' \
--header 'apikey: YourApiKey' \
--data-urlencode 'userid=YourUsername' \
--data-urlencode 'output=json' \
--data-urlencode 'action=list' \
--data-urlencode 'uuId=17324567890' \
--data-urlencode 'page=1' \
--data-urlencode 'limit=50'
Sample Success Response
{
"status": "success",
"dlrList": [
{
"uuId": "6226901107781419438",
"botName": "YourBot",
"mobileNo": "919876543210",
"msgId": "Zr6dILs7iZt1pvO",
"message": "{\"contentMessage\":{\"templateMessage\":{\"templateCode\":\"WELCOME_TEMPLATE\"}},\"ttl\":\"86400s\"}",
"amount": "0.0000",
"msgTypeLabel": "RICH",
"directionLabel": "A2P",
"globalErrorCode": 5007,
"deliveryStatus": "FAILED",
"cause": "RCS Not Enabled",
"channelLabel": "API",
"campaignName": "",
"submitTime": 1788421063350,
"submitTimeFormatted": "2026-09-03 13:07:43",
"deliveryTime": 1788421066059,
"deliveryTimeFormatted": "2026-09-03 13:07:46",
"readTime": 0,
"readTimeFormatted": "",
"clickedTime": 0,
"clickedTimeFormatted": ""
}
],
"totalRecords": 1,
"page": 1,
"limit": 50,
"fromDate": "2026-09-03 00:00:00",
"toDate": "2026-09-03 23:59:59",
"statusCode": "200",
"reason": "success"
}
Sample Error Response
{
"status": "error",
"dlrList": [],
"statusCode": "403",
"reason": "RCS API access is not enabled for this account."
}Testimonials
