Telegram Message Summary REST API
Telegram Message Summary REST API for SMSGatewayCenter APIs
Telegram Message Summary REST API
Use the Message Summary REST API to fetch aggregated Telegram message counts for your account over HTTP. Ideal for dashboards, daily reconciliation, and automated reporting. This endpoint accepts GET requests and returns JSON.
API Endpoint
https://unify.smsgateway.center/rest/tg/v1/summaryLegacy alias without v1 in the path is also supported: /rest/tg/summary
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 summary date range. Format YYYY-MM-DD or full date/time. Alias: from. | 2026-07-01 00:00:00 |
| toDate | Optional | End of summary date range. Format YYYY-MM-DD or full date/time. Alias: to. | 2026-07-07 23:59:59 |
| sendMethod | Optional | Filter by direction: 1 outgoing, 2 incoming. | 1 |
| 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/summary?userid=YourUsername&password=xxxxx&output=json&action=list&fromDate=2026-06-30&toDate=2026-07-07&sendMethod=1&page=1&limit=50'
Sample Success Response
{
"status": "success",
"summaryList": [
{
"summaryId": "88",
"sendMethod": 1,
"sendMethodName": "Outgoing",
"total": 120,
"success": 115,
"failed": 3,
"pending": 2,
"summaryTime": 1712345678901,
"summaryTimeFormatted": "2026-07-07 10:14:38"
}
],
"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",
"summaryList": [],
"statusCode": "403",
"reason": "Telegram API access is not enabled for this account."
}
Notes
- Each summary row represents aggregated counts for a time bucket (outgoing or incoming).
sendMethod1is outgoing (messages you sent) and2is incoming (messages received).- Results are ordered by
summaryTimedescending (newest first).
Testimonials
Why do Great Businesses Trust SMS Gateway Center?
