SMS
Get SMS status
https://api.smsedge.com/v1/sms/get/Returns the status, delivery report, cost and click data of messages you sent through the API.
Send ids, campaign_id or both. You can ask for 1,000 IDs max in one request.
status is sent, waiting, failed or unknown. dlr_status is the operator delivery report, for example Delivered or Undelivered, and unknown until a report arrives. cost and parts are present after the message is sent.
An ID that is not found is listed in errors. The response is still 200, and success is false if no message is found.
Query params
idsstringoptionalComma-separated message IDs from Send a single SMS. Required if campaign_id is not set. 1,000 max.
campaign_idintegeroptionalReturns the API messages attached to this campaign. Required if ids is not set.
Responses
- 200Message details
- 400Neither ids nor campaign_id is set, or more than 1,000 IDs. The other message is "Too many SMS ids provided [1200], maximum [1000]".
- 401The API key is missing, wrong or the account is blocked
- 404campaign_id is not one of your campaigns
curl -X GET "https://api.smsedge.com/v1/sms/get/?ids=48210377%2C48210378&campaign_id=244614" \
-H "X-API-KEY: YOUR_API_KEY"[
{
"success": true,
"data": [
{
"id": 48210377,
"created": "2026-11-16 14:10:02",
"updated": "2026-11-16 14:10:05",
"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": true,
"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"
}
],
"errors": [
"SMS with specified id [48210378] was not found"
],
"response": {
"code": 200,
"description": "OK",
"date": "2026-11-16 14:20:00"
},
"api": {
"version": "v1",
"module": "sms",
"function": "get"
},
"user": {
"id": 736
}
}
]All requests need your API key in the X-API-KEY header. See Authentication.