Get grouped history
Get your sent history grouped per send: a group send is returned as one entry with the total amount of receivers, instead of one entry per receiver.
Base URL:
GET: https://api.smsgatewayapi.com/v1/message/history
| Parameter | Input | Description | |
|---|---|---|---|
| client_id | API client ID | Login and go to 'Developer' - 'API & Webhooks' - 'API-credentials' to find the API keys | Required |
| client_secret | API client secret | Login and go to 'Developer' - 'API & Webhooks' - 'API-credentials' to find the API keys | Required |
| limit | Maximum results per page | Default up to 1000, can't be bigger than 2000 | Optional |
| page | Page of results | Default up to 1 | Optional |
<?php //PHP - cURL $ch = curl_init(); $url = "https://api.smsgatewayapi.com/v1/message/history"; $client_id = "XXX"; // Your API client ID (required) $client_secret = "YYY"; // Your API client secret (required)
curl_setopt($ch, CURLOPT_URL, "$url"); curl_setopt($ch, CURLOPT_POST, false); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET'); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_VERBOSE, true); curl_setopt($ch, CURLOPT_HTTPHEADER, [ "X-Client-Id: $client_id", "X-Client-Secret: $client_secret", "Content-Type: application/json", ]); $response = curl_exec($ch); ?>
Example success response:
{
"total": 20,
"shown": 20,
"page": 1,
"limit": 1000,
"messages": [
{
"ID": 1234567,
"public_ID": "cnv_3520a1ec234dbabe1232def67e858855",
"message": "Hello [FIRSTNAME]",
"to": "marketing",
"sender": "YourName",
"date": "2026-08-01 11:24:02",
"amount": 250,
"type": "group"
},
{
"ID": 1234566,
"public_ID": "cnv_46f4c0e37652d4149352e1cb54fed50b",
"message": "Hello World",
"to": "{nr}",
"sender": "YourName",
"date": "2026-08-01 10:12:44",
"amount": 1,
"type": "single",
"status": "DELIVERED"
},
...
]
}
For the grouped history of a subaccount, use https://api.smsgatewayapi.com/v1/message/history/subaccount/{subaccount_id}.
