Developers
One API for the whole panel
The dashboard is a client of this API. Keys are hashed at rest, rate limited to 120 requests per minute and every call is logged.
Authentication
Bearer tokens
Create a key in the dashboard under API keys. Send it as Authorization: Bearer … or the X-API-Key header. Revoking a key is immediate.
Account
GET /api/v1/balance
Wallet balance and currency.
GET /api/v1/me
Account profile and limits.
Numbers
GET /api/v1/countries
Countries with live stock counts.
GET /api/v1/services
Services available for verification.
GET /api/v1/numbers/price?country=1&service=907
Quote a route before buying.
GET /api/v1/numbers/orders?limit=25
Your recent number orders with codes.
POST /api/v1/numbers/orders
Reserve a number. Body: { country, service }.
GET /api/v1/numbers/orders/{id}
Status, phone number and the received code.
POST /api/v1/numbers/orders/{id}/cancel
Release the number and refund the wallet.
Social boost
GET /api/v1/boost/services
All boost services with rates and limits.
POST /api/v1/boost/orders
Body: { service, link, quantity }.
GET /api/v1/boost/orders/{id}
Delivery progress and remaining units.
eSIM, gift cards, airtime
GET /api/v1/esim/plans
Plans with retail prices.
POST /api/v1/esim/orders
Body: { plan }. Returns ICCID + activation code.
GET /api/v1/giftcards
Brands and denominations.
POST /api/v1/giftcards/orders
Body: { card, denomination }.
GET /api/v1/airtime/operators
Operators by country.
POST /api/v1/airtime/orders
Body: { operator, phone, amount }.
Quick start
curl -X POST https://your-domain.com/api/v1/numbers/orders \
-H "Authorization: Bearer ps_live_xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"country": 42, "service": 907}'
# → {"id": 812, "status": "waiting", "phone": "+233 54 666 4975", "price": 1.1}
curl https://your-domain.com/api/v1/numbers/orders/812 \
-H "Authorization: Bearer ps_live_xxxxxxxxxxxxxxxx"
# → {"id": 812, "status": "received", "code": "482193", ...}Conventions
- Errors return
{ "error": "…", "code": "…" }with a matching HTTP status. - Money is always USD with two decimals.
- Idempotency — number orders are single-shot; retry only after a non-2xx response.
- Rate limits — 120 requests per minute per key,
429on breach. - Statuses — numbers: waiting, received, cancelled, refunded, expired.
Webhooks
Poll the order endpoint — it is cheap and rate limited generously. Signed webhooks are on the roadmap; the order payload already includes everything a webhook would carry.