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.

SHA-256 hashed keys JSON in, JSON out Scoped per account

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, 429 on 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.

API reference · PanelSuite