⚡ Reseller API · partner prices

Sell virtual numbers from your own site, bot or app

The DuoTalk reseller API lets your software buy private virtual phone numbers and read SMS verification codes, automatically, at a partner price below our public price. You set your own selling price to your customers and keep the difference. One balance, one key, ten simple actions.

  • ✓ Partner price, 10% below public by default
  • ✓ Never pay for a number that didn't work
  • ✓ JSON over HTTPS, works in any language
buy a number
curl -X POST https://theduotalk.io/api/v1.php \
  -H "Authorization: Bearer $DUOTALK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action":"buy","app_id":73,"qty":1}'
200 OK
{
  "ok": true,
  "data": {
    "order_id": 1048,
    "numbers": [
      {
        "id": 2291,
        "tel": "14845550147",
        "title": "WhatsApp",
        "end_time": "in 60 minutes"
      }
    ],
    "balance": "24.62"
  }
}
2,400+services you can resell
7countries with live stock
~10 stypical code delivery
2suppliers with automatic failover
What it is

A wholesale number API for people who sell to their own customers

Many people already sell SMS verification numbers: Telegram bots that hand out a WhatsApp number in two taps, small websites with their own price list, panels for marketing teams, and QA teams that test sign-up flows every day. All of them need the same thing behind the scenes: a reliable place to buy a fresh number, read the code that arrives on it, and get their money back when a number doesn't work. The DuoTalk reseller API is that place.

Your software sends a request, DuoTalk reserves a real number from live stock, and your customer sees it in your interface, not ours. When the verification code arrives, you fetch it with one more request and show it to your customer. DuoTalk's name never needs to appear anywhere in your product. You decide the price your customers pay; you pay DuoTalk the partner price from your balance; the difference is your margin.

Everything runs on the same system that powers theduotalk.io: the same stock, the same delivery, the same refund rules and the same balance. If a number works in our dashboard, it works through the API, and the reverse.

Who it's for

Built for four kinds of partners

🤖

Telegram and Discord bots

Sell numbers inside a chat. Your bot calls catalog to show prices, buy when a user pays, and sms to deliver the code a few seconds later.

🛒

Resale websites and panels

Run your own storefront with your own brand and prices. Load the full price list once a minute and let your customers order from your site.

🧪

QA and growth teams

Test sign-up and login flows that need a real phone number, with numbers in the United States, the United Kingdom, Canada and more, paid from one company balance.

🧩

Agencies and developers

Add phone verification to a product you build for a client without building supplier contracts, payments or refund handling yourself.

Partner pricing

You buy below our public price, and you set your own

Every API partner gets a partner price. By default it is 10% below the public price shown on theduotalk.io, and partners who sell more can get a higher discount, set individually for their account. The catalog action always returns two prices for every service: price, which is what you pay, and retail_price, the public price, so you can show your customers a fair comparison or simply add your own margin on top.

Example servicePublic priceYour partner priceYou could sell atYour margin
WhatsApp · United States$0.40$0.36$0.55$0.19
Telegram · United Kingdom$1.50$1.35$1.90$0.55
Google · Canada$0.24$0.21$0.35$0.14

Example prices for illustration. Live prices change with stock; catalog always returns the current ones for your account.

There are no monthly fees, no setup fees and no minimum volume. You only pay for numbers you buy, and the price is taken from your DuoTalk balance at the moment of purchase. Your partner price applies to every purchase made with your API key; purchases you make yourself in the dashboard use the normal public price.

Getting started

From sign-up to your first number in five steps

  1. 1

    Create a DuoTalk account

    Sign up at theduotalk.io with your email. It takes a minute and works for individuals and companies.

  2. 2

    Request API access

    Open Reseller API in your account and tell us in a sentence or two what you will build, for example a Telegram bot that sells WhatsApp numbers, about 50 a day. We review every request and switch access on, usually the same day.

  3. 3

    Create your API key

    Once access is on, create a key from the same page. You confirm with your password, the key is shown once, and only a fingerprint of it is stored on our side. You can delete it and create a new one at any time.

  4. 4

    Add balance

    Top up with crypto: USDT (TRC20 or BEP20), TRX, LTC, ETH or BTC. The balance is added automatically when the payment confirms and is shared by the dashboard and the API.

  5. 5

    Make your first call

    Call balance to check the key, catalog to load prices, then buy and sms. The examples below are complete and ready to paste.

How a request looks

One endpoint, one header, one JSON body

Every request is a POST to a single endpoint with your key in the Authorization header and the action in a JSON body. Every answer is JSON with ok set to true and the result in data, or ok set to false with a readable error message and a matching HTTP status. You can use it from any language that can send HTTPS requests: PHP, Python, Node.js, Go, or a no-code tool.

POSThttps://theduotalk.io/api/v1.php
1 · check your balance
curl -X POST https://theduotalk.io/api/v1.php \
  -H "Authorization: Bearer $DUOTALK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action":"balance"}'
2 · load your price list
curl -X POST https://theduotalk.io/api/v1.php \
  -H "Authorization: Bearer $DUOTALK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action":"catalog","type":1}'
3 · read the code
curl -X POST https://theduotalk.io/api/v1.php \
  -H "Authorization: Bearer $DUOTALK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action":"sms","number_id":2291}'

A typical flow in your product: your customer picks a service and pays you; your server calls buy; you show the returned number; your server calls sms every five to ten seconds until a code appears, then shows it. If no code arrives in time, call extend once for free, and if the number still does not work, call report. That is the whole integration.

Worked example

A Telegram bot that sells WhatsApp numbers, step by step

Here is how a typical partner builds a number shop inside Telegram. The same steps apply to a website or a Discord bot; only the screens change.

  1. A

    Show the menu

    When a user opens your bot, your server calls catalog (cache it for a minute) and shows the services your users want most, such as WhatsApp, Telegram and Google, with your own prices next to each one.

  2. B

    Take payment your way

    Your user pays you in whatever way your shop already accepts. DuoTalk never talks to your customers, so their payment and their account stay with you.

  3. C

    Buy the number

    As soon as the payment clears, your server calls buy with the service's app_id. The answer contains the number and its id. Send the number to your user and store the id next to their order.

  4. D

    Deliver the code

    Your server calls sms with that id every five to ten seconds. When the answer contains a code, send it to your user and stop polling. Most codes arrive within seconds.

  5. E

    Handle the rare failure

    If nothing arrives before the access time ends, call extend once. If that also fails, call report and tell your user they'll get a new number or their money back. DuoTalk refunds a failed number to your balance after review, so you can refund your user without losing money.

A small bot like this is usually a few hundred lines of code. Most of the work is your own menu and payments; the DuoTalk part is four actions.

Pricing your shop

How to choose the price your customers pay

Your margin is the difference between the price you charge and your partner price, so a few simple rules go a long way:

📊

Start from retail_price

The public price is a natural ceiling: customers who compare will find it. Many partners sell slightly below it and still earn the full partner discount as margin.

🎯

Price popular services keenly

WhatsApp, Telegram and Google numbers sell in volume. A small margin on many orders often beats a large margin on a few.

🔄

Refresh prices often

Prices follow live stock and can change during the day. Reload catalog regularly and keep a small buffer so a price change never turns an order into a loss.

Errors

Every error tells you what to do next

Errors come back with ok set to false, an HTTP status and a plain-English message you can show to your own staff. The ones you will meet most often:

401Invalid key, or API access is not on for the account. Check the key, or create a new one.
402Not enough balance for this purchase. Top up, then try again.
409That area code or service just ran out of stock. Try another area code, "Any", or another country.
429Too many requests in a minute. Slow down your polling and retry after a few seconds.
502We could not confirm a purchase with the supplier. Don't buy again: our team checks it and either delivers the number or refunds your balance.
503Our number suppliers are briefly unavailable. Wait a moment and try again.

If a purchase was charged but your request timed out before the answer arrived, call numbers: the number will be in your list. Never repeat a purchase blindly after a timeout, or you may buy two numbers.

Reference

All ten actions

balance—Your balance in USD.
catalogtype (optional: 1 first card, 2 restart, 3 renewal)Every country and service you can buy, with your partner price, the public price and live stock.
area_codesapp_id, typeArea codes in stock for one service, with how many numbers each has.
buyapp_id, qty (1–10), prefix (optional), type (optional)Buys numbers at your partner price and returns them with their ids. The price is taken from your balance.
numbers—Your active numbers with their access time, last code and status.
smsnumber_idChecks the number for new messages and returns the latest code.
sms_historynumber_id (optional)Every message received, newest first.
extendnumber_idExtends a number once, free, when no code has arrived yet.
renewnumber_idRenews a number that supports renewal, at the renewal price.
reportnumber_id, reason, detailsReports a number that did not work. Reports are reviewed and refunded to your balance when the number failed.

The full reference with every field is on the API reference page.

Numbers, codes and refunds

Clear rules, so you can promise them to your customers

⏱️

Access time

A one-time number stays yours for a set window (60 minutes by default), with a few extra minutes after a code arrives, so your customer can finish signing up.

🔁

One free extension

If no code has arrived yet, extend gives the number more time once, at no cost. Many slow services deliver during the extension.

💸

Refund on failed numbers

If a number never receives a code, report it. Reports are reviewed and the price goes back to your balance when the number failed, so you are not paying for numbers that didn't work.

Numbers receive SMS only. They cannot send messages or receive calls. A one-time number receives codes from the service you bought it for; if your customers need one number for several apps or for repeated logins, use a renewable number type from the catalog with type 3 and the renew action.

Reliability

Built so your customers don't notice when something goes wrong

🛡️

Two suppliers, automatic failover

Every purchase goes to our main number supplier first. If it refuses an order (out of stock, a balance or account problem, a server error), the order moves to a backup supplier automatically, and your request still returns a number.

🚫

No double purchases

If an answer is lost on the way, DuoTalk never buys a second time on its own. The order is checked by our team and either delivered or refunded, so a network hiccup cannot charge you twice.

📈

Fair rate limits

120 requests per minute per key, and up to 30 purchases per minute. Poll for codes every five to ten seconds per number and you will stay far below the limit.

🔐

Keys you control

Keys are created with your password, shown once and stored only as a fingerprint. Lock a key to your server's IP addresses, set a daily spending limit, and see every IP that used it. A key used from a new address raises an alert, and wrong keys get the guessing IP blocked.

Fair use

What the API can and can't be used for

✓ Welcome

  • Reselling verification numbers to your own customers
  • Testing your own apps' sign-up and login flows
  • Keeping personal numbers private when creating accounts
  • Building bots, panels and tools on top of DuoTalk

✕ Not allowed

  • Getting around a ban or a block on a service
  • Creating fake or bulk accounts to spam or deceive
  • Bypassing identity or age checks (KYC)
  • Fraud, harassment or anything illegal where you or your customers are

You are responsible for how your customers use the numbers you sell. Accounts that break these rules lose API access. If you are unsure whether your use case fits, ask us before you build.

Questions

Frequently asked questions

How much does API access cost?

Nothing. There are no monthly or setup fees. You pay only for the numbers you buy, at your partner price, from your DuoTalk balance.

How big is the partner discount?

Every partner gets 10% below the public price by default. Partners with steady volume can get a higher discount, set for their account. Ask us when your volume grows.

Can I show my own brand and prices to my customers?

Yes. Your customers only see your interface. You decide the price they pay; the API returns both your partner price and the public price so you can choose your margin.

How fast do codes arrive?

Most codes arrive within seconds of the service sending them. Poll the sms action every five to ten seconds while your customer waits.

What happens if a number doesn't receive a code?

Extend it once for free. If it still doesn't work, report it with the report action. When the number failed, the price goes back to your balance after review.

Which countries and services are available?

Numbers in the United States, the United Kingdom, Canada, Hong Kong, Indonesia and more, for over 2,400 services. The catalog action returns the live list with stock.

How do I pay?

Top up your balance with crypto: USDT (TRC20 or BEP20), TRX, LTC, ETH or BTC. The balance is added automatically when the payment confirms and is shared with the dashboard.

Can I test before going live?

Yes. Start with a small top-up and buy a few cheap numbers through the API. Failed numbers are refunded after review, so testing costs very little.

Start selling numbers under your own brand

Request API access, get your partner price, and make your first call today.