Reports

Get sending report

GEThttps://api.smsedge.com/v1/reports/sending/

Returns the messages you sent through the API, newest first, with status, cost and click data.

Each item has the same fields as Get SMS status. The report covers messages sent through the API, not campaign messages.

Use limit and offset to page through the results. limit is 1,000 max. A value below 1 or above 1,000 is set to 1,000. pagination.total is the number of matching messages.

Dates accept YYYY-MM-DD or YYYY-MM-DD HH:MM:SS. When no message matches, the response is 404. An invalid status also returns 404.

With an agency API key, the report includes the messages of the agency's customer accounts.

Query params

  • statusstringoptional

    Returns only messages with this status.

    Values: sent, waiting, failed

  • date_fromstringoptional

    Returns only messages created on or after this date.

  • date_tostringoptional

    Returns only messages created on or before this date.

  • limitintegeroptional

    Number of messages to return. 1,000 max.

    Default: 1000

  • offsetintegeroptional

    Number of messages to skip.

    Default: 0

Responses

  • 200Sent messages
  • 401The API key is missing, wrong or the account is blocked
  • 404No message matches the filters. An invalid status returns "Invalid status requested" with the same code.
curl -X GET "https://api.smsedge.com/v1/reports/sending/?status=sent&date_from=2026-11-01" \
  -H "X-API-KEY: YOUR_API_KEY"
[
  {
    "success": true,
    "data": [
      {
        "id": 48210377,
        "created": "2026-11-12 15:27:21",
        "updated": "2026-11-12 15:27:24",
        "from": "MyBrand",
        "to": 447700900123,
        "verify_local": 1,
        "shorten_url": 1,
        "list_id": null,
        "reference": "order-10045",
        "transactional": 0,
        "preferred_route_id": null,
        "campaign_id": null,
        "delay_time": null,
        "country_id": 225,
        "country_name": "United Kingdom",
        "country_iso": "GB",
        "conversion_key": "a1b2c3d4e5",
        "conversion_pixel": {
          "lead": "http://edgepxl.com/postback.php?type=lead&key=a1b2c3d4e5",
          "sale": "http://edgepxl.com/postback.php?type=sale&key=a1b2c3d4e5"
        },
        "clicked": false,
        "cost": 0.0412,
        "parts": 1,
        "original_url": "https://example.com/track",
        "shortened_url": "https://exmpl.link/aB3dE",
        "text": "Hi John, your order has shipped. Track it: https://exmpl.link/aB3dE",
        "status": "sent",
        "dlr_status": "Delivered"
      },
      {
        "id": 48210301,
        "created": "2026-11-12 15:20:10",
        "updated": "2026-11-12 15:20:12",
        "from": "MyBrand",
        "to": 447700900456,
        "verify_local": 1,
        "shorten_url": 0,
        "list_id": null,
        "reference": null,
        "transactional": 1,
        "preferred_route_id": null,
        "campaign_id": null,
        "delay_time": null,
        "country_id": 225,
        "country_name": "United Kingdom",
        "country_iso": "GB",
        "clicked": false,
        "cost": 0.0412,
        "parts": 1,
        "text": "Your verification code is 482913",
        "status": "sent",
        "dlr_status": "Delivered"
      }
    ],
    "errors": [],
    "pagination": {
      "limit": 100,
      "offset": 0,
      "total": 2
    },
    "response": {
      "code": 200,
      "description": "OK",
      "date": "2026-11-16 14:00:21"
    },
    "api": {
      "version": "v1",
      "module": "reports",
      "function": "sending"
    },
    "user": {
      "id": 736
    }
  }
]

All requests need your API key in the X-API-KEY header. See Authentication.