Reports

Get sending statistics

GEThttps://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_idintegerrequired

    Country ID. See List countries.

  • date_fromstringrequired

    Start of the period (YYYY-MM-DD or YYYY-MM-DD HH:MM:SS).

  • date_tostringrequired

    End of the period. 7 days max after date_from.

  • route_idintegeroptional

    Returns 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.