Message status

Fetch one outbound SMS by the id returned from Send.

GET/api/v1/sms/:id

Authorization: Bearer sk_sms_…

Statuses

Parameter	Type	Description
`pending / queued`	status	Accepted; waiting on the phone to send.
`sent`	status	Handed to the network.
`delivered`	status	Delivery report received (when available).
`failed`	status	Could not send.
`cancelled`	status	Cancelled before send.

Examples

curl https://waaguan.com/api/v1/sms/MESSAGE_ID \
  -H "Authorization: Bearer sk_sms_YOUR_SMS_SECRET_KEY"

Response

{
  "status": true,
  "message": "SMS retrieved",
  "data": {
    "id": "3f2a1b4c-5d6e-7f80-91a2-b3c4d5e6f708",
    "to": "+233244123456",
    "from": "0244123456",
    "message": "Your OTP is 48291",
    "status": "pending",
    "smsgate_message_id": "zXDYfTmTVf3iMd16zzdBj",
    "error": null,
    "created_at": "2026-07-20T22:00:00.000Z",
    "metadata": {}
  }
}

Dashboard history: SMS → History.