API reference · SMS

Get message status

Check whether a message was delivered, and why it failed if it did.

GET/v1/sms/{message_id}/status

Bearer API key
Rate limit 300 / min
Returns 200 OK
Needs the SMS permission · free

GET /v1/sms/{message_id}/status

curl https://api.talks.africa/v1/sms/sms_8f2k1x/status \
  -H "Authorization: Bearer $TALKS_KEY"

{
  "id": "sms_8f2k1x",
  "status": "failed",
  "to": "+254712345678",
  "failed_at": "2026-11-13T19:25:10Z",
  "error_code": "absent_subscriber",
  "error_message": "Phone switched off or out of coverage"
}

Use a tk_test_ key while you build. Nothing is sent and no credits are used.

Parameters

message_idstringrequired
The message ID from when you sent it.

Response fieldsResponse

status
queued, sent, delivered or failed
delivered_at · failed_at
When it finished
error_code · error_message
Why it failed

Errors

Tap one to see its response above.

All errors use the standard error object. Select one to see its response.

Was this page helpful?