Key Takeaways
- TypeScript Android SMS gateway API in depth is fetch/undici with your own types — not an official npm “Complete TypeScript SDK.”
- Confirm live fields in Developer Center. HTTP 200 is accepted, not delivered.
- Keys in server env only. Timeouts and Idempotency-Key on every send.
- Isolate OTP deviceIds. Unknown DLR statuses fail closed.
- You bring the Android and operator SMS credit. We meter devices and send volume.
fetch + types, not an npm SDK
TypeScript Android SMS gateway API in depth: typed request/response wrappers you maintain, server-side Bearer auth, and DLR join. Hub: Android SMS gateway API. Node cousin: Node parse DLR. Live fields: Developer Center.
If package.json depends on “@sms-gateway/official-sdk,” you branded fiction.
REST HTTPS/JSON only
fetch, undici, or ky — the contract is HTTP. Samples: PHP HTTPS/JSON, C# HTTPS/JSON. External: TypeScript everyday types.
Client duties
| Layer | Owns | Must not |
|---|---|---|
| TypeScript service | Types, auth header, timeouts, idempotency | Ship keys to the browser |
| Control plane | Queue, device assignment, webhooks | Supply operator airtime |
| Android + SIM | GSM submit / DLR when available | Survive empty prepaid silently |
Types you own
Generate or hand-write interfaces from Developer Center — re-check after API changes. OTP isolation: OTP verification.
Cost
Devices plus SMS send volume. Operator airtime is yours. Retries still debit the SIM. Free: 1 device / 300 SMS lifetime. Developer: 25,000 SMS/year. Starter / Professional / Business uncap platform volume with device caps 2 / 5 / 15; carrier fair-use still applies. Starter, Professional, and Business list Unlimited SMS as platform send volume; that is not unmetered carrier SMS.
Checklist
- Server-only keys; AbortSignal timeouts.
- Idempotency-Key stable on retry.
- Persist id; DLR mapper fails closed on unknown.
- OTP deviceIds isolated.
- No npm “official SDK” claim.
Next steps
pricing, setup, TypeScript send SMS.
Related product pages
Jump to the live product docs for this topic—not another long-form article.
- SMS API documentationLive endpoint reference
- device and SMS volume pricingPlans and allowances
- Android SMS gateway product guideDefinition, product, and how to buy
- download the Android gateway appGet the APK




