UPDATE
Public API v1 is Live: Automate virtual numbers on DS SMS HUB- check balance, buy OTP numbers, and get codes via our secure API. Request access in Developer API Learn More

← Back to Blog

DS SMS HUB Public API v1: Buy Virtual Numbers Programmatically

DS SMS HUB Public API v1: Buy Virtual Numbers Programmatically

October 1, 2026

If you build apps, SaaS tools, or automation that needs SMS verification numbers in Nigeria, you no longer have to click through a dashboard for every order. DS SMS HUB Public API v1 lets you buy virtual numbers, check your wallet balance, poll OTP codes, and cancel orders — all over HTTPS with secure API keys.


What you can do with API v1

  • Check wallet balance in Naira

  • List enabled servers (Server 1–6)

  • Fetch countries, services, and live prices

  • Purchase a number with an Idempotency-Key (no accidental double charge)

  • Poll order status and receive the OTP when it arrives

  • Cancel waiting orders with provider-first refunds (safe, no double refund)


Built for developers — without exposing internals

API responses only use clear labels like Server 1, Server 5 (USA Only), and Server 6 (Global & USA). Pricing is calculated on our side the same way as the website — clients cannot override price, balance, or order status.


How to get started

  1. Log in to your DS SMS HUB account

  2. Open Developer API

  3. If access is inactive, tap Request API Access on WhatsApp (message is pre-filled)

  4. Once we activate your account, create a Public API key (shown once — store it safely)

  5. Call GET /api/v1/balance with Authorization: Bearer YOUR_KEY


curl -s "https://dssmshub.com/api/v1/balance" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Accept: application/json"


Buy a number (example)

curl -s -X POST "https://dssmshub.com/api/v1/otp/orders" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Idempotency-Key: unique-request-id-123" \
  -H "Content-Type: application/json" \
  -d '{"server":1,"service":"whatsapp","country":"1"}'


Then poll GET /api/v1/otp/orders/{id} until sms_code appears — or set a webhook URL in Developer Center to receive signed OTP notifications.


Security highlights

  • Hashed API keys (raw key shown only once)

  • Scopes such as balance:read, numbers:buy, orders:cancel

  • Rate limits + request IDs on every response

  • Webhook signing with X-DSS-Signature


Same wallet, same reliability

API orders use your existing DS SMS HUB wallet. Fund once on the website or app, then automate purchases from your own product. Need data, airtime, electricity, or social boosts too? Those stay on the dashboard and mobile app — OTP numbers are what API v1 unlocks first.


Ready to integrate? Open Developer API in your account, request access if needed, and read the full documentation on our site.

Join channel