Reseller API v1

1. Sign up and add credit to your account (Cryptomus / Stripe / Paddle / PayTR / Shopier).
2. Open the API keys page, click Create key — the key is shown once and also emailed to you. Store it in a secret manager or environment variable. Format: sk_live_… (56 chars).
3. Send it as an HTTP header on every request:

   Authorization: Bearer sk_live_…

4. Start with GET /balance to confirm the key works, then GET /services → GET /countries → POST /order → poll GET /order/{id}.

Returns the current account balance in USD. Call before ordering to make sure you have funds.

curl -H "Authorization: Bearer $KEY" https://smsverifyo.com/api/public/v1/balance

{
  "ok": true,
  "balance_usd": 42.5000,
  "currency": "USD",
  "email": "you@example.com",
  "username": "reseller1"
}

Lists every enabled service (WhatsApp, Telegram, Google, etc.). Cache this — it changes rarely.

curl -H "Authorization: Bearer $KEY" https://smsverifyo.com/api/public/v1/services

{
  "ok": true,
  "services": [
    { "id": "d0…uuid", "code": "wa", "name": "WhatsApp" },
    { "id": "e1…uuid", "code": "tg", "name": "Telegram" }
  ]
}

Lists countries available for a given service with live per-number pricing and availability.

curl -H "Authorization: Bearer $KEY" \
  "https://smsverifyo.com/api/public/v1/countries?service_id=SERVICE_UUID"

{
  "ok": true,
  "countries": [
    { "country_id": 0, "name": "Russia",  "flag": "🇷🇺", "price_usd": 0.15, "available": 42 },
    { "country_id": 1, "name": "Ukraine", "flag": "🇺🇦", "price_usd": 0.22, "available":  8 }
  ]
}

Rents a number. Atomically debits your balance and returns the phone number. Order starts in status waiting.

curl -X POST -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"service_id":"SERVICE_UUID","country_id":0}' \
  https://smsverifyo.com/api/public/v1/order

{
  "ok": true,
  "order": {
    "id": "b7…uuid",
    "phone": "79001234567",
    "status": "waiting",
    "price_usd": 0.18,
    "balance_usd": 42.32,
    "expires_at": "2026-07-03T02:00:00Z"
  }
}

Polls an order. Poll every 3–5 seconds. When the SMS arrives, status becomes received and sms_code is returned.

curl -H "Authorization: Bearer $KEY" https://smsverifyo.com/api/public/v1/order/ORDER_ID

{
  "ok": true,
  "order": {
    "id": "b7…uuid",
    "phone": "79001234567",
    "status": "received",
    "sms_code": "123456",
    "received_at": "2026-07-03T01:32:11Z"
  }
}

Cancels a waiting order after the cooldown window and refunds the balance. Not allowed once an SMS has arrived.

curl -X POST -H "Authorization: Bearer $KEY" \
  https://smsverifyo.com/api/public/v1/order/ORDER_ID/cancel

{ "ok": true, "status": "cancelled", "balance_usd": 42.50 }

Marks an order as finished once you're done with the code. Optional — orders auto-finalize after expiry.

curl -X POST -H "Authorization: Bearer $KEY" \
  https://smsverifyo.com/api/public/v1/order/ORDER_ID/finish

{ "ok": true, "status": "finished" }