GET/public/sms/:id

Get message status

Looks up a single message by its ID. Requires the sms.send or sms.read scope. There are no push webhooks for this yet (see Webhooks) - poll this endpoint on your own schedule if you need to know when a message reaches DELIVERED.

Example request

curl

curl https://app.simplisend.co.za/api/v1/public/sms/cl9x1234abcd \
  -H "X-API-Key: YOUR_API_KEY"

Response - 200 OK

{
  "id": "cl9x1234abcd",
  "toMsisdn": "+27821234567",
  "status": "DELIVERED",
  "deliveryStatus": null,
  "sentAt": "2026-08-01T09:12:03.000Z",
  "deliveredAt": "2026-08-01T09:12:07.000Z"
}

Field	Type	Description
id	string	The message ID.
toMsisdn	string	Normalised destination number.
status	string	QUEUED, SENDING, SENT, DELIVERED, FAILED, or BLOCKED.
deliveryStatus	string \| null	Failure or provider detail text, when available.
sentAt	string \| null	ISO timestamp the message was accepted by the network.
deliveredAt	string \| null	ISO timestamp the carrier confirmed delivery, if known yet.

* required

Error responses

404 - no message with that ID on your account
403 - API key missing both sms.send and sms.read scopes