API Documentation

Alias: getNumberV2 also works — both return the same unified response.

You are charged only when a number is delivered; the amount is the price in the response. Every country has its own price (see getPrices) and maxPrice protects you from paying more than you expect. Country codes are our own ids (India = 22, Indonesia = 6, USA = 187), not phone dialling codes — get them from getCountries.

• A number can be cancelled only while no SMS has arrived. Once a code is received the order is final (ALREADY_FINISHED).
• A cancel is accepted only after the cancel lock — the cancel_lock seconds returned by getNumber (it depends on the service, from about 15 s up to about 130 s — always read it from the response). Earlier than that you get EARLY_CANCEL_DENIED with wait_seconds; just call again after that time.
• A cancelled order is refunded to your wallet at once. An order that gets no SMS within expires_in seconds expires and is refunded automatically.

Same as getStatus with &format=json, but always returns JSON. While waiting "sms" is null; when a code arrives "sms" holds code and text. The status field is the order state: pending, waiting_next, completed, cancelled or expired.

Alias: getServices also works. Returns every active service with its listed price in INR, whether it is available, and whether it supports multiple SMS. Each country has its own price — read it with getPrices / getProviders.

Country codes are our own ids (India = 22, Indonesia = 6, USA = 187), not phone dialling codes. Use code as the country parameter of getNumber / getPrices. flag is the country's flag emoji. The entry 999999 (ANY_COUNTRY) is a placeholder, not a country — ignore it.

Every country has its own price — look it up before you buy. Prices are in INR. Always pass service.

Returns all of your still-open activations together with any SMS already received — replacing one getStatus call per number with a single request. If you are holding 200 numbers, that is 1 request instead of 200.

There is no maximum. Called without parameters it returns every open activation you hold, however many that is.

Only activations from the last 20 minutes are returned — that is the lifetime of a number (expires_in is always 1200), so anything older has already expired. Pass max_age to widen that window.

Each item in activeActivations has exactly the same shape as a getStatusV2 response for a single activation, so existing per-order parsing code works unchanged — just loop over the array.

Empty list. When you hold no open activations the response is {"status":"NO_ACTIVATIONS","total":0,"activeActivations":[]} — check total or the array length rather than assuming status is always success.

Polling tip. Poll this once every few seconds instead of polling each activation separately. It reads from our database — which our servers keep continuously up to date — so it stays fast no matter how many numbers you hold.

Request a new OTP on the same phone number as a previously completed order. Only for services that support multiple OTPs (multi_sms: true). Charges the same price as the original order. Poll the returned new_activation_id with getStatus to receive the new OTP.