Reports
Get sending statistics
https://api.smsedge.com/v1/reports/stats/Returns totals for messages sent through the API to one country in a period of up to 7 days.
The totals are sent, clicks, cost, signups (leads) and ftds (sales). ctr is clicks divided by sent, as a fraction rounded to 2 decimals (0.12 = 12%). Signups and FTDs need a conversion pixel.
country_id, date_from and date_to are required. The period is 7 days max. All validation errors return 404, with every problem listed in errors.
With an agency API key, the totals include the agency's customer accounts.
Query params
country_idintegerrequiredCountry ID. See List countries.
date_fromstringrequiredStart of the period (YYYY-MM-DD or YYYY-MM-DD HH:MM:SS).
date_tostringrequiredEnd of the period. 7 days max after date_from.
route_idintegeroptionalReturns only messages sent through this route. See List routes.
Responses
- 200Totals for the period
- 401The API key is missing, wrong or the account is blocked
- 404No message matches, or a parameter is invalid. Other messages: "Invalid country_id requested", "Invalid route_id requested", "Invalid date_from requested", "Invalid date_to requested", "No sending activity found".
curl -X GET "https://api.smsedge.com/v1/reports/stats/?country_id=225&date_from=2026-11-09&date_to=2026-11-15%2023%3A59%3A59" \
-H "X-API-KEY: YOUR_API_KEY"[
{
"success": true,
"data": {
"clicks": 61,
"sent": 512,
"ctr": 0.12,
"cost": 21.09,
"signups": 4,
"ftds": 1
},
"errors": [],
"response": {
"code": 200,
"description": "OK",
"date": "2026-11-16 14:00:44"
},
"api": {
"version": "v1",
"module": "reports",
"function": "stats"
},
"user": {
"id": 736
}
}
]All requests need your API key in the X-API-KEY header. See Authentication.