API documentation

Authentication

Create a key under API keys in your dashboard and send it as api_key on every request. Keys are shown once — store them securely and never expose them in browser code.

curl "https://your-domain.com/api/public/v1/handler?api_key=itm_xxxxxxxxxxxxxxxx&action=getBalance"

Error responses

Full example

Order a WhatsApp number in Indonesia, wait for the code, then close the activation.

const API = "https://your-domain.com/api/public/v1/handler";
const KEY = process.env.ITEMODE_API_KEY;

// 1. Order a number
const order = await fetch(`${API}?api_key=${KEY}&action=getNumber&service=wa&country=6`)
  .then((r) => r.text());
const [, activationId, phone] = order.split(":");

// 2. Poll for the code (max 20 minutes)
let code = null;
for (let i = 0; i < 200 && !code; i++) {
  await new Promise((r) => setTimeout(r, 5000));
  const status = await fetch(`${API}?api_key=${KEY}&action=getStatus&id=${activationId}`)
    .then((r) => r.text());
  if (status.startsWith("STATUS_OK")) code = status.split(":")[1];
  if (status === "STATUS_CANCEL") break;
}

// 3. Close the activation
await fetch(`${API}?api_key=${KEY}&action=setStatus&id=${activationId}&status=${code ? 6 : 8}`);

console.log({ phone, code });