SMS

Get send-list job status

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

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