Buy SMS verification numbers programmatically — the same numbers, prices and wallet as the website, from your own code.
Log in to generate and manage your API key.
Use your API key to buy numbers, check your balance and read SMS codes from your own code. Send the key as ?api_key=… or an Authorization: Bearer header.
Loading API key status…
Your new API key — copy it now, it will not be shown again:
—⚠ API numbers are final sale — if a number never receives a code, there is no replacement and no refund.
Three steps: get a key, top up your wallet, call the API. Numbers cost the same as on the website (provider cost × 1.40) and are charged to your wallet at purchase.
Log in, open your dashboard, and find the API access section. Click Generate API key and copy it — the full key is shown only once. If you lose it, regenerate it (the old key stops working immediately).
Top up from the dashboard (Binance, or instant USDT BEP20; card payments coming soon). API buys are charged to this wallet — if the balance does not cover the price, the buy is rejected.
Buy a number with GET /api/v1/number, then poll GET /api/v1/status until the SMS code arrives. See the endpoints below.
API numbers are charged at purchase and are final. If a number never receives a code, there is no free replacement and no refund — the number simply expires after 20 minutes. This is different from website orders, which are refunded automatically if no code arrives. Only use the API if you accept this. Cancelling a number releases it but also gives no refund.
All endpoints live under:
Send your key in one of two ways — as a query parameter or as a Bearer token. Both work on every endpoint.
Every response is JSON. Amounts are in units: 1 unit = $0.0001 (so $1.00 = 10,000 units). Prices shown on the website in Rs. use 1 USD = Rs. 290.
GET /api/v1/balanceCheck your wallet balance.
GET /api/v1/numberBuy one number immediately. The wallet is charged at purchase.
| Parameter | Required | Description |
|---|---|---|
service | Yes | Service code, e.g. wa (WhatsApp), tg (Telegram), go (Google). |
country | Yes | Country ID, e.g. 187 (USA), 66 (Pakistan), 16 (UK), 60 (Bangladesh). See /api/v1/prices for all pairs. |
operator | No | Operator option ID. Omit for the cheapest option. |
maxPrice | No | Maximum price in USD. The cheapest option at or below this price is picked; if none qualifies, the request fails with MAX_PRICE_EXCEEDED. |
minPrice | No | Minimum price in USD. Only options at or above this price are considered; if none qualifies, the request fails with MIN_PRICE_EXCEEDED. |
cost is what was charged to your wallet, in units. The number stays active for 20 minutes.
OTP link (v2.14): every bought number also returns an otpToken. Open https://revenuering.duckdns.org/ringverify/otp.html?token=<otpToken> in any browser — no login needed — and the code appears there when it arrives. Give the link to your customer, not the API key: anyone holding the link can see that number's code.
GET /api/v1/statusCheck an order’s status and read the SMS code when it arrives. Poll every few seconds until status is received.
Possible statuses: waiting, received, confirmed, cancelled, expired.
GET /api/v1/cancelCancel a waiting number and release it. No refund — API numbers are final sale. Numbers can only be cancelled 2 minutes after purchase.
GET /api/v1/pricesThe full price list — every service and country, with the cheapest price per pair. Same data as the website’s live prices.
maxPrice and minPrice (USD) filter the list to pairs whose cheapest price is within the range.
| HTTP | Error | Meaning |
|---|---|---|
| 400 | INVALID_REQUEST | Missing or invalid parameters. |
| 400 | INVALID_SERVICE_OR_COUNTRY | That service/country pair is not available. |
| 400 | INVALID_OPERATOR | Unknown operator option for this pair. |
| 400 | INVALID_ID | The id parameter is missing or not a number. |
| 401 | INVALID_API_KEY | Missing, wrong, or regenerated API key. |
| 402 | INSUFFICIENT_BALANCE | Wallet balance does not cover the price. Top up and retry. |
| 404 | NOT_FOUND | No order with that id belongs to your key. |
| 409 | INVALID_STATUS | That action is not available for this order any more. |
| 409 | EARLY_CANCEL_DENIED | Numbers can only be cancelled 2 minutes after purchase. |
| 400 | MAX_PRICE_EXCEEDED | No option for this pair costs at most maxPrice USD. |
| 400 | MIN_PRICE_EXCEEDED | No option for this pair costs at least minPrice USD. |
| 429 | RATE_LIMITED | More than 60 API requests per minute for this key. Slow down. |
| 502 | NO_NUMBERS / PROVIDER_ERROR | No numbers left for that pair, or the provider failed. Retry or pick another pair. |
At most 60 API requests per minute per key (HTTP 429 beyond that). Number purchases are additionally limited by the provider to 1 per second — buy requests are queued and served in order, so a burst of buys simply takes a few seconds each.