A delivery receipt is the status message returned by the carrier for an SMS, reporting that the message was delivered to the handset, failed, or expired, sometimes with an error code.
Once a message has been handed to a carrier, the carrier's message centre (SMSC) tries to deliver it and reports the outcome back along the route: delivered when the handset acknowledged it, failed with a reason when it could not be delivered, expired when the validity period ran out first. That report is the delivery receipt, DLR in telecom vocabulary. It is what turns sent into delivered, failed or expired in a gateway's records.
Between carriers and gateways, receipts commonly travel over SMPP as short text records with fields such as stat:DELIVRD, stat:UNDELIV or stat:EXPIRED and an error code. Each part of a long message gets its own receipt at that level, so a gateway has to combine them into one status. Receipts may come back within seconds, hours later, or in batches when an operator sends them that way.
Receipts are only as honest as the route. Some operators return a handset receipt, some stop at acceptance, and grey routes fabricate them. Knowing which applies in each country is essential to reading a report. Hypothetically, a reminder to a phone that is on shows delivered a few seconds after sent; the same reminder to a phone switched off for three days shows sent, then expired once a 48-hour validity runs out, with no delivered in between.
Three readings to avoid:
- Sent read as delivered. Sent only means a carrier took the message.
- A missing receipt read as a failure. In some countries no handset receipt ever comes.
- A late or replayed earlier event allowed to overwrite a final status. Statuses move forward only.
At SMSMeteor: receipts drive the status of each message, and the outcome reaches you as a message.delivered, message.failed or message.expired webhook. Most destinations return handset receipts, so delivered means the phone got the message; a few give carrier acknowledgement only, and there sent is the final positive state. Each country page says which applies.
