Key Takeaways
- DLR means delivery report — evidence the SMS reached a terminal state (delivered/failed/etc.), not the first HTTP 200.
- On an Android SIM gateway, DLR depends on device + operator support; always design for “unknown/pending”.
- Prefer webhooks + message id correlation; poll only as backup.
- You need a working Android phone with a SIM and SMS credit from your mobile operator. Operator message costs are yours—we do not sell carrier SMS balance. Service pricing is based on device count and total SMS sent through the gateway.
- Free canaries: 300 SMS lifetime — not Unlimited SMS.
Glossary: what is DLR for android sms gateway. Feature page: delivery reports. Webhooks: webhooks. Docs: SMS API documentation.
You need a working Android phone with a SIM and SMS credit from your mobile operator. Operator message costs are yours—we do not sell carrier SMS balance. Service pricing is based on device count and total SMS sent through the gateway. Pricing.
What DLR means
Delivery report / delivery receipt: operator/handset feedback after submit. Exact enums vary — trust OpenAPI names, not folklore.
Design OTP UX for “accepted” first and “delivered” when DLR arrives. Collapsing them hides radio outages.
Android gateway context
The phone app and SIM participate in getting reports back. Offline devices delay truth. Pairing: setup.
Accept vs delivered
| Signal | Means | App action |
|---|---|---|
| HTTP 2xx send | Control plane accepted | Store message id |
| Pending / queued | Waiting on device/network | Watch device health |
| Delivered DLR | Terminal success (when provided) | Clear OTP wait / notify |
| Failed DLR | Terminal failure | Policy-based retry / fallback |
How to consume DLR
Prefer signed webhooks; poll GET message as backup. Idempotent handlers. Related: idempotency.
Carrier limits
Some operators never return rich DLR. Budget support playbooks for “no receipt.” Failed retries still burn airtime.
Next steps
Wire a staging webhook, canary one SMS, confirm the event. Best practices deep dives live under DLR blog spokes.
Related product pages
Jump to the live product docs for this topic—not another long-form article.
- SMS delivery reports (DLR)Delivery status tracking
- SMS API documentationLive endpoint reference
- device and SMS volume pricingPlans and allowances
- Android SMS gateway product guideDefinition, product, and how to buy
