SMS activation API

Reserves a number and charges your balance. The price is final — if no SMS arrives before the activation expires, the full amount is refunded automatically. If the cheapest server runs out mid-purchase we fail over to the next one at the same price or lower.

curl "https://dualsms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getNumber&service=wa&country=22"

ACCESS_NUMBER:66f1c0a2e4b0c1a2b3c4d5e6:919810427735

Identical to getNumber, but the answer is JSON and includes what you were charged and when the activation started.

curl "https://dualsms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getNumberV2&service=wa&country=22"

{
  "activationId": "66f1c0a2e4b0c1a2b3c4d5e6",
  "phoneNumber": "919810427735",
  "activationCost": "12.00",
  "countryCode": 22,
  "activationTime": "2026-10-20T10:56:00.000Z"
}

Moves an activation forward. Cancel (8) refunds the full price as long as no SMS has arrived; it may be refused for the first two minutes (EARLY_CANCEL_DENIED) while the provider is still delivering. Complete (6) closes the activation once you have your code.

curl "https://dualsms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=setStatus&id=66f1c0a2e4b0c1a2b3c4d5e6&status=6"

ACCESS_ACTIVATION

Returns the current state of an activation and the code once it arrives. Poll every 3–5 seconds — or skip polling entirely and receive codes on your webhook.

curl "https://dualsms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getStatus&id=66f1c0a2e4b0c1a2b3c4d5e6"

STATUS_OK:482913

JSON version of getStatus, including the complete SMS text and when it was received — useful when the message contains more than a numeric code.

curl "https://dualsms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getStatusV2&id=66f1c0a2e4b0c1a2b3c4d5e6"

{
  "verificationType": 0,
  "sms": { "dateTime": "2026-10-20 10:56:07", "code": "482913", "text": "Your WhatsApp code: 482-913" },
  "call": null,
  "status": "STATUS_OK"
}

Returns every open activation on your account — handy after a restart of your bot, to pick up where it left off.

curl "https://dualsms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getActiveActivations"

{
  "status": "success",
  "activeActivations": [
    {
      "activationId": "66f1c0a2e4b0c1a2b3c4d5e6",
      "serviceCode": "wa",
      "phoneNumber": "919810427735",
      "activationCost": "12.00",
      "activationStatus": "2",
      "smsCode": ["482913"],
      "smsText": ["Your WhatsApp code: 482-913"],
      "activationTime": "2026-10-20 10:56:00",
      "countryCode": "22"
    }
  ]
}

The balance you can spend now, in the site currency, with two decimals. Money on hold on your account isn't included.

curl "https://dualsms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getBalance"

ACCESS_BALANCE:976.00

Your price and how many numbers are available, grouped by country id then service code. Filter with service and/or country to keep the answer small. Cached for one minute.

curl "https://dualsms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getPrices&service=wa&country=22"

{
  "22": {
    "wa": { "cost": 12, "count": 4310 }
  }
}

Like getPrices, but split by server: country id → service code → server number → your price, available numbers and the server's id and name. Pass the ids you want to getNumber as providerIds (or operator). Same shape as SMSBower's getPricesV3. Cached for one minute.

curl "https://dualsms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getPricesV3&service=wa&country=22"

{
  "22": {
    "wa": {
      "1": { "price": 12, "count": 3100, "provider_id": 1, "provider_name": "Server 1" },
      "3": { "price": 14.5, "count": 1210, "provider_id": 3, "provider_name": "Server 3" }
    }
  }
}

Every country you can buy numbers in, keyed by the id to pass as country.

curl "https://dualsms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getCountries"

{
  "22": { "id": 22, "eng": "India", "iso": "in", "visible": 1 },
  "6": { "id": 6, "eng": "Indonesia", "iso": "id", "visible": 1 }
}

Every service you can buy numbers for, with the code to pass as service.

curl "https://dualsms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getServicesList"

{
  "status": "success",
  "services": [
    { "code": "wa", "name": "WhatsApp" },
    { "code": "tg", "name": "Telegram" }
  ]
}

Reserves an email address and charges your balance. If no code arrives before the address closes, it's cancelled and the full price is refunded automatically. Leave out domain to get the cheapest domain in stock. A ref parameter is accepted and ignored.

curl "https://dualsms.com/api/mail/getActivation?api_key=YOUR_API_KEY&service=tg&domain=gmail.com"

{
  "status": 1,
  "mail": "[email protected]",
  "mailId": 100001
}

Returns the latest code that arrived on the address. Until it arrives — and while you wait for the next code after setStatus 5 — the answer is “Code has not been received yet, please try again later”. Poll every 3–5 seconds. Most emails give a short code, but some services send a verification link or a whole email instead: then code is that link, or the email's text / HTML, exactly as it arrived.

curl "https://dualsms.com/api/mail/getCode?api_key=YOUR_API_KEY&mailId=100001"

{
  "status": 1,
  "code": "123456"
}

The state of an address as a number (see Mail statuses), its last code, and whether you can ask for another code with setStatus 5.

curl "https://dualsms.com/api/mail/getStatus?api_key=YOUR_API_KEY&id=100001"

{
  "status": 1,
  "data": {
    "status": 3,
    "status_description": "Mail has been activated",
    "available_to_get_next_code": true,
    "last_code": "123456"
  }
}

Cancel (2) refunds the full price — only before a code has arrived. Finish (3) closes the address once you have your code. Next code (5) keeps the same address open for another code at no extra cost.

curl "https://dualsms.com/api/mail/setStatus?api_key=YOUR_API_KEY&id=100001&status=3"

{
  "status": 1,
  "message": "Activation succeed"
}

Your price per email and how many are in stock, grouped by service code then email domain. Only what is in stock is listed — an empty data means nothing is on sale right now. Filter with service and/or domain to keep the answer small. Cached for 30 seconds.

curl "https://dualsms.com/api/mail/getPriceRests?api_key=YOUR_API_KEY&service=tg"

{
  "status": 1,
  "data": {
    "tg": {
      "gmail.com": { "price": "162.00", "count": 5678 },
      "outlook.com": { "price": "24.00", "count": 1240 }
    }
  }
}

The balance you can spend now, in the site currency, with two decimals — the same wallet the numbers API uses (money on hold isn't included). An extra beyond the standard mail protocol.

curl "https://dualsms.com/api/mail/getBalance?api_key=YOUR_API_KEY"

{
  "status": 1,
  "balance": "976.00"
}