eSMS AfricaeSMS Africa
SMS Platform

Delivery Reports

Track SMS delivery status and view message logs.

Check delivery status

After sending an SMS, check its delivery status:

curl https://sms.esmsafrica.io/api/messages/{id} \
  -H "Authorization: Bearer esms_live_your_api_key"

Prefer push over polling: set a delivery webhook in your dashboard settings and eSMS POSTs the final status (delivered or failed) to your endpoint - see Webhooks.

Delivery statuses

StatusDescription
queuedMessage accepted and queued for sending
scheduledWaiting for its scheduled send time
submittedAccepted by the gateway
sentAccepted by the carrier network, awaiting a handset receipt
deliveredDelivery confirmed by the handset
unknownWe're confirming delivery with the network after a gateway timeout (shown as Confirming in the dashboard and confirming in CSV exports). It resolves to sent (or a later status), or to failed with an automatic refund, within about 10 minutes. It cannot be retried while confirming.
retryingA failed attempt is being retried
failedDelivery failed or was rejected (unreachable number, gateway rejection, insufficient balance)

SMS logs

View all sent messages in the dashboard at SMS Logs. Each log entry shows:

  • Recipient phone number
  • Message content
  • Sender ID used
  • Delivery status
  • Timestamp
  • Cost

SMS reports

Detailed delivery reports are available at SMS Reports, including:

  • Total messages sent
  • Delivery success rate
  • Failed message breakdown
  • Cost summary

On this page