Documentação da API

1) Comprar um número de WhatsApp no Brasil
GET https://meusms.com/stubs/handler_api.php?api_key=SUA_API_KEY&action=getNumber&service=wa&country=73
→ ACCESS_NUMBER:12345:5511999998888      (12345 = id da ativação)

2) Consultar a cada 3–5 segundos até o código chegar
GET https://meusms.com/stubs/handler_api.php?api_key=SUA_API_KEY&action=getStatus&id=12345
→ STATUS_WAIT_CODE … STATUS_OK:384720

3) Concluir (ou cancelar com status=8 se o SMS não vier)
GET https://meusms.com/stubs/handler_api.php?api_key=SUA_API_KEY&action=setStatus&id=12345&status=6
→ ACCESS_ACTIVATION

handler_api — Servidor 1, operadora surf:
GET https://meusms.com/stubs/handler_api.php?api_key=SUA_API_KEY&action=getNumber&service=wa&country=73&server=1&operator=surf

handler_api — Servidor 2, linha virtual51:
GET ...&action=getNumber&service=wa&country=73&server=2&operator=virtual51

REST — Servidor 1, operadora tim:
curl -X POST -H "X-Api-Key: SUA_API_KEY" -H "Content-Type: application/json" \
  -d '{"product": "whatsapp", "server": 1, "operator": "tim"}' https://meusms.com/api/v1/orders
→ 201 {"id": 12345, "operator": "tim", "server": 1, ...}

REST — só responde para serviços com mais de um país (os demais devolvem 404):
curl -H "X-Api-Key: SUA_API_KEY" "https://meusms.com/api/v1/services/instagram/countries?server=2"
→ [{"country": "brazil", "price": "2.02", "count": 10511405},
   {"country": "usa",    "price": "2.15", "count": 71830}]

handler_api — preços de um país (só os serviços liberados nele):
GET ...&action=getPrices&country=187&server=2
→ {"187": {"ig": {"cost": 2.15, "count": 71830}, "dr": {"cost": 1.49, "count": 25962}}}

Comprar nos EUA:
REST:        -d '{"product": "instagram", "country": "usa", "server": 2}'
handler_api: ...&action=getNumber&service=ig&country=187&server=2

https://meusms.com/stubs/handler_api.php

GET https://meusms.com/stubs/handler_api.php?api_key=SUA_API_KEY&action=getNumber&service=wa&country=73
→ ACCESS_NUMBER:12345:5511999998888

Pelo Servidor 2:
GET ...&action=getNumber&service=wa&country=73&server=2

Servidor 3, escolhendo operadora e DDD (DDD = +30% no preço):
GET ...&action=getNumber&service=tg&country=73&server=3&operator=vivo&ddd=11

GET ...&action=getStatus&id=12345
→ STATUS_WAIT_CODE      ainda sem SMS
→ STATUS_OK:384720      código recebido
→ STATUS_CANCEL         cancelado, expirado ou concluído sem SMS

Se o SMS não tem código numérico (ex.: um link), STATUS_OK traz o texto inteiro.

Pedir outro SMS (depois do 1º código):
GET ...&action=setStatus&id=12345&status=3   → ACCESS_RETRY_GET
GET ...&action=getStatus&id=12345            → STATUS_WAIT_RETRY:384720 … STATUS_OK:novo

Nova ativação no MESMO número (só Servidor 3; cobra o preço do serviço de novo):
GET ...&action=getExtraActivation&activationId=12345 → ACCESS_NUMBER:12346:5511999998888

GET ...&action=getPrices&server=1
→ {"73": {"wa": {"cost": 15.45, "count": 26049}, "tg": {"cost": 3.50, "count": 280114}, ...}}

GET ...&action=getNumbersStatus&server=1   → {"wa_0": 26049, "tg_0": 280114, ...}
GET ...&action=getServicesList&server=1    → {"status": "success", "services": [{"code": "wa", "name": "whatsapp"}, ...]}
GET ...&action=getCountries                → {"73": {"id": 73, "eng": "brazil", ...}, "187": {...}}

Com &country=ID, getPrices e getNumbersStatus trazem o preço e o estoque daquele país.
No Servidor 3 o preço listado é sem DDD; com &ddd o valor sobe 30%.

curl -H "X-Api-Key: SUA_API_KEY" https://meusms.com/api/v1/balance
→ {"balance": "42.50", "frozen": "0.00", "currency": "BRL"}

curl -H "X-Api-Key: SUA_API_KEY" "https://meusms.com/api/v1/services?server=1&search=whats"
→ [{"product": "whatsapp", "price": "15.45", "count": 26049, "rate": null, "countries": []}]

curl -X POST -H "X-Api-Key: SUA_API_KEY" -H "Content-Type: application/json" \
  -d '{"product": "whatsapp", "server": 1}' https://meusms.com/api/v1/orders
→ 201 {"id": 12345, "phone": "5511999998888", "status": "PENDING", "price": "15.45", "server": 1, ...}

Servidor 3 com operadora e DDD:
  -d '{"product": "telegram", "server": 3, "operator": "vivo", "ddd": 11}'

curl -H "X-Api-Key: SUA_API_KEY" https://meusms.com/api/v1/orders/12345
→ {"id": 12345, "status": "RECEIVED",
   "messages": [{"code": "384720", "text": "Seu código é 384720", "sender": "...", "received_at": "..."}], ...}

curl -X POST -H "X-Api-Key: SUA_API_KEY" https://meusms.com/api/v1/orders/12345/finish
curl -X POST -H "X-Api-Key: SUA_API_KEY" https://meusms.com/api/v1/orders/12345/cancel
curl -X POST -H "X-Api-Key: SUA_API_KEY" https://meusms.com/api/v1/orders/12345/resend
curl -X POST -H "X-Api-Key: SUA_API_KEY" https://meusms.com/api/v1/orders/12345/reuse

import time
import requests

API = "https://meusms.com/stubs/handler_api.php"
KEY = "SUA_API_KEY"


def call(**params):
    r = requests.get(API, params={"api_key": KEY, **params}, timeout=30)
    return r.text.strip()


resp = call(action="getNumber", service="wa", country=73, server=1)
if not resp.startswith("ACCESS_NUMBER"):
    raise SystemExit("Não comprou: " + resp)   # NO_BALANCE, NO_NUMBERS...
_, activation_id, phone = resp.split(":")
print("Número:", phone)

limite = time.time() + 20 * 60
while time.time() < limite:
    status = call(action="getStatus", id=activation_id)
    if status.startswith("STATUS_OK"):
        print("Código:", status.split(":", 1)[1])
        call(action="setStatus", id=activation_id, status=6)   # concluir
        break
    if status == "STATUS_CANCEL":
        print("Ativação encerrada sem SMS")
        break
    time.sleep(4)
else:
    print("Sem SMS, cancelando:", call(action="setStatus", id=activation_id, status=8))

const API = "https://meusms.com/api/v1";
const headers = { "X-Api-Key": "SUA_API_KEY", "Content-Type": "application/json" };
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));

async function main() {
  const buy = await fetch(`${API}/orders`, {
    method: "POST",
    headers,
    body: JSON.stringify({ product: "telegram", server: 1 }),
  });
  const order = await buy.json();
  if (!buy.ok) throw new Error(`${buy.status}: ${JSON.stringify(order.detail)}`);
  console.log("Número:", order.phone);

  for (let i = 0; i < 300; i++) {          // ~20 min
    await sleep(4000);
    const o = await (await fetch(`${API}/orders/${order.id}`, { headers })).json();
    if (o.messages.length) {
      const sms = o.messages[o.messages.length - 1];
      console.log("Código:", sms.code || sms.text);
      await fetch(`${API}/orders/${order.id}/finish`, { method: "POST", headers });
      return;
    }
    if (["CANCELED", "TIMEOUT", "BANNED"].includes(o.status)) {
      return console.log("Encerrado:", o.status);
    }
  }
  const c = await fetch(`${API}/orders/${order.id}/cancel`, { method: "POST", headers });
  console.log("Sem SMS, cancelado:", c.status);
}

main().catch(console.error);

<?php
$api = "https://meusms.com/stubs/handler_api.php";
$key = "SUA_API_KEY";

function call($api, $key, $params) {
    $url = $api . "?" . http_build_query(array_merge(["api_key" => $key], $params));
    return trim(file_get_contents($url));
}

$resp = call($api, $key, ["action" => "getNumber", "service" => "wa", "country" => 73]);
if (strpos($resp, "ACCESS_NUMBER") !== 0) exit("Não comprou: $resp\n");
[, $id, $phone] = explode(":", $resp);
echo "Número: $phone\n";

for ($i = 0; $i < 300; $i++) {
    sleep(4);
    $status = call($api, $key, ["action" => "getStatus", "id" => $id]);
    if (strpos($status, "STATUS_OK:") === 0) {
        echo "Código: " . substr($status, 10) . "\n";
        call($api, $key, ["action" => "setStatus", "id" => $id, "status" => 6]);
        exit;
    }
    if ($status === "STATUS_CANCEL") exit("Encerrado sem SMS\n");
}
echo "Cancelando: " . call($api, $key, ["action" => "setStatus", "id" => $id, "status" => 8]) . "\n";