SMS
Get send-list job status
GET
https://api.smsedge.com/v1/sms/send-list-status/Returns the progress of a background send-list job.
status is one of queued, running, done, error or stopped. Progress is saved after each batch of 500 numbers. queued + failed + skipped equals total when the job is done. errors keeps the first 50 errors only.
Query params
job_idintegerrequiredThe job_id returned by Send SMS to a list.
Responses
- 200Job progress
- 400job_id is missing
- 401The API key is missing, wrong or the account is blocked
- 404No job with this ID on your account
curl -X GET "https://api.smsedge.com/v1/sms/send-list-status/?job_id=1532" \
-H "X-API-KEY: YOUR_API_KEY"[
{
"success": true,
"data": {
"job_id": 1532,
"list_id": 2070,
"status": "running",
"total": 17250,
"queued": 9500,
"failed": 2,
"skipped": 0,
"date_created": "2026-11-16 14:12:40",
"started_at": "2026-11-16 14:12:41",
"finished_at": null,
"errors": [
"No routing to destination [to] - number [447700900123]",
"No routing to destination [to] - number [447700900456]"
]
},
"errors": [],
"response": {
"code": 200,
"description": "OK",
"date": "2026-11-16 14:13:30"
},
"api": {
"version": "v1",
"module": "sms",
"function": "send-list-status"
},
"user": {
"id": 736
}
}
]All requests need your API key in the X-API-KEY header. See Authentication.