API Documentation

Connect SMSOX to your own software.

Base URL

Send your key in the X-API-Key header (or the api_key query parameter). All responses are JSON. Errors return "ok": false with "code" and "message".

curl -H "X-API-Key: API_ANAHTARINIZ" https://demo3.colaksoftware.com.tr/api/v1/balance

GET/api/v1/balance

Cash and promo balance

{ "ok": true, "balance": 125.5, "promo": 10, "currency": "TRY" }

GET/api/v1/services

All services with starting price

{ "ok": true, "services": [{ "code": "whatsapp", "name": "WhatsApp", "from_price": 18.5 }] }

GET/api/v1/countries?service=whatsapp

Countries, price and stock

{ "ok": true, "countries": [{ "country": "TR", "name": "Türkiye", "price": 42.5, "stock": 120 }] }

POST/api/v1/order

Buy a number. Body: {"service":"whatsapp","country":"TR","max_price":50}

{ "ok": true, "order": { "id": "k3x…", "phone": "905…", "price": 42.5, "status": "PENDING", "expires_at": "…" } }

GET/api/v1/order/{id}

Order status and SMS code

{ "ok": true, "order": { "status": "RECEIVED", "code": "482913", "sms_text": "…" } }

POST/api/v1/order/{id}/cancel

Cancel and refund

{ "ok": true, "order": { "status": "CANCELED" } }

POST/api/v1/order/{id}/finish

Complete

{ "ok": true, "order": { "status": "FINISHED" } }

POST/api/v1/order/{id}/retry

Request another SMS

{ "ok": true }

GET/api/v1/orders?status=PENDING

Your recent orders

{ "ok": true, "orders": [ … ] }

SMS-Activate compatible endpoint

Supported actions: getBalance, getNumber, getNumberV2, getStatus, setStatus (8 cancel, 6 finish, 3 retry), getPrices, getCountries, getServicesList. service = our code (whatsapp) or SMS-Activate code (wa); country = ISO (TR) or SMS-Activate id.

https://demo3.colaksoftware.com.tr/stubs/handler_api.php?api_key=API_ANAHTARINIZ&action=getNumber&service=wa&country=TR
ACCESS_NUMBER:k3x9…:905xxxxxxxxx
https://demo3.colaksoftware.com.tr/stubs/handler_api.php?api_key=API_ANAHTARINIZ&action=getStatus&id=k3x9…
STATUS_OK:482913