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
| Status | Description |
|---|---|
queued | Message accepted and queued for sending |
scheduled | Waiting for its scheduled send time |
submitted | Accepted by the gateway |
sent | Accepted by the carrier network, awaiting a handset receipt |
delivered | Delivery confirmed by the handset |
unknown | We'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. |
retrying | A failed attempt is being retried |
failed | Delivery 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