Key Takeaways
- Python DLR parsing is requests/httpx + json into your store — not an official PyPI SMS SDK we sell.
- HTTP 200 on send is accepted, not delivered. Persist the message id.
- Unknown status strings fail closed. Confirm enums in Developer Center.
- Webhook HMAC plus a poll repair job for phones that were offline.
- Do not clone the Node parse-DLR spoke word-for-word; same physics, different runtime.
- You bring the Android and operator credit. We meter devices and send volume.
json.loads the radio, not a pip SDK
Python parse DLR from an Android SMS gateway API maps a status payload onto the message id you stored at accept time. It is REST HTTPS/JSON. It is not a branded SDK, not a rewrite of the API guide, and not a clone of Node parse DLR.
If unknown strings become “delivered” in your mapper, pip was never the problem.
Not a Python SDK product
requests or httpx plus json.loads is a sample. Language cousins: PHP HTTPS/JSON, C# HTTPS/JSON. Live enums: Developer Center. External: Python json docs.
Status families
| Family | Your store | Must not |
|---|---|---|
| Accepted / queued | Pending | Show “delivered” to the user |
| Delivered | Terminal success | Ignore duplicate webhook delivery |
| Failed / rejected | Terminal fail + reason | Blind auto-resend without policy |
| Unknown string | Fail closed / alert | Default to delivered |
Webhook vs poll repair
Prefer signed webhooks for push; run a poll repair for devices that were offline. OTP isolation: OTP verification. DLR depth: delivery reports guide.
Cost
Devices plus SMS send volume. Operator airtime is yours. Accepted sends and retries still meter. Free: 1 device / 300 SMS lifetime. Starter, Professional, and Business list Unlimited SMS as platform send volume; that is not unmetered carrier SMS.
Checklist
- Persist id at accept; join DLR on that id.
- Unknown statuses alert; never coerce to delivered.
- Webhook HMAC verified; idempotent consumer.
- Poll repair for stale pending.
- Keys in env; Developer Center enums confirmed.
Next steps
Python send SMS, devices and SMS volume, setup.
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
