Key Takeaways
- Use curl to prove HTTPS + auth + a real SIM. Copy live path, headers, and JSON from Developer Center — not from this article.
- This is not a Complete SDK. REST is HTTPS/JSON. Do not paste API keys into tickets or blog comments.
- HTTP 200 means accepted. Inbox + DLR prove the radio.
- Demo/Free canaries may append a footer and pause at the lifetime cap.
- You bring the Android and operator credit. Platform pricing is devices plus send volume.
Query curl android sms gateway api wants a command they can paste. The pasteable contract is Developer Center. This page is how not to lie to yourself with a 200. API overview, gateway model.
You bring a phone and airtime. Devices and send volume. PHP/C# pages are samples, not packages: PHP HTTPS/JSON.
$ curl -sS -X POST … # fields from Developer Center
Curl is a canary, not production
Pair the APK first. Install, setup. Then one staff MSISDN. Do not loop curl in bash against OTP — that is a retry storm.
A gist with Bearer eyJ… is not documentation. It is a stolen modem.
Request shape (confirm live)
Typical habit: Authorization: Bearer from env, JSON body with destination and text as documented today. Version the client after you pin fields. Version integrations. Idempotency on OTP retries.
Status table
| Curl result | Means | Next |
|---|---|---|
| 401 / 403 | Token / env | Rotate; never commit |
| 4xx validation | Stale JSON | Developer Center, not this blog |
| 200, empty inbox | Accept ≠ radio | Pairing, airtime, OEM. DLR |
| Footer on SMS | Demo/Free | Expected (www.sms-gateway.app on demo) |
Tokens stay in the shell env
$SMS_GATEWAY_TOKEN, not argv history. Keys in env.
200 is not delivered
Cold handset. Real handsets. Isolate OTP. OTP. Messaging practices. Queue: backlog.
Next steps
One documented POST to a staff SIM, then put the same fields in your app. Spend 300 lifetime SMS on that canary — it is a cap, not unmetered curl.
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
