Developer API
Everything the site does,
over REST.
These are the exact endpoints behind the storefront. Order numbers, collect codes and issue eSIMs from your own apps, bots and scripts.
Endpoints
7 routes- GET
/api/services
List available countries and services.
- GET
/api/prices?country=us&service=whatsapp
Live prices and availability for a country.
- POST
/api/numbers
Order a number — { "countryId": "us", "serviceId": "whatsapp" }.
- GET
/api/numbers/:id
Order status — poll until an SMS lands in order.sms[].
- POST
/api/numbers/:id
Finish or cancel — { "action": "finish" | "cancel" }.
- GET
/api/esim/packages?country=japan
eSIM catalog, optionally filtered by destination.
- POST
/api/esim/orders
Issue an eSIM — { "packageId": "jp-10gb-30d" } → QR and code.
order.sh
curl -X POST https://smokedsms.app/api/numbers \
-H "Content-Type: application/json" \
-d '{"countryId":"us","serviceId":"whatsapp"}'GET /api/numbers/:id
{
"order": {
"phone": "+1 415 555 0134",
"status": "received",
"sms": [{ "code": "482913",
"text": "Your WhatsApp code is 482-913" }]
}
}Try it before you write a line.
Order a real number in the demo, watch the code arrive, then hit the same call from your terminal.