Telegram Recipients REST API
Telegram Recipients REST API for SMSGatewayCenter APIs
Telegram Recipients REST API
Use the Recipients REST API to fetch distinct Telegram inbox contacts for a date range over HTTP. Use this list to pick chatId values when sending Telegram messages from mobile apps or third-party integrations. This endpoint accepts GET requests and returns JSON.
API Endpoint
https://unify.smsgateway.center/rest/tg/v1/recipientsLegacy alias without v1 in the path is also supported: /rest/tg/recipients
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. Telegram Chat API access must be enabled on your account.
| 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 received date range. Format YYYY-MM-DD or full date/time. Alias: from. Defaults to today when omitted with toDate. | 2026-07-14 |
| toDate | Optional | End of received date range. Format YYYY-MM-DD or full date/time. Alias: to. Defaults to today when omitted with fromDate. | 2026-07-14 |
| 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/recipients?userid=YourUsername&password=xxxxx&output=json&action=list&fromDate=2026-07-14&toDate=2026-07-14&page=1&limit=50'
Sample Request Code - API Key (cURL)
curl --location --get 'https://unify.smsgateway.center/rest/tg/v1/recipients' \
--header 'apikey: YOUR_API_KEY' \
--data-urlencode 'userid=YourUsername' \
--data-urlencode 'output=json' \
--data-urlencode 'action=list' \
--data-urlencode 'fromDate=2026-07-14' \
--data-urlencode 'toDate=2026-07-14' \
--data-urlencode 'page=1' \
--data-urlencode 'limit=50'
Sample Success Response
{
"status": "success",
"recipientsList": [
{
"chatId": "123456789",
"telegramUserId": "987654321",
"displayName": "Rahul",
"firstName": "Rahul",
"username": "rahul_demo"
}
],
"totalRecords": 1,
"page": 1,
"limit": 50,
"fromDate": "2026-07-14 00:00:00",
"toDate": "2026-07-14 23:59:59",
"statusCode": "200",
"reason": "success"
}
Sample Error Response
{
"status": "error",
"recipientsList": [],
"statusCode": "403",
"reason": "Telegram API access is not enabled for this account."
}
Related
Testimonials
