API 2.0 (Current)

Our API is a protocol for interaction between your software and our activation server. The API automates the process of receiving SMS messages on your side.

Endpoint URL

All API requests should be sent via POST or GET methods to:

https://heyalex.store/stubs/handler_api.php

🔑 Authentication

All requests to the API must include your API key as the api_key parameter.

Your API Key
••••••••••••••••••••••••••••••••
Security Notice: Keep your API key secure. Do not share it in client-side code or public repositories.
GET
💰 Get Balance

Retrieve your current account balance

https://heyalex.store/stubs/handler_api.php?api_key=$api_key&action=getBalance
FieldTypeReqDescription
actionStringYesMust be getBalance
api_keyStringYesYour unique API key
CodeValue / Description
ACCESS_BALANCE:100.20Current account balance.
CodeDescription
BAD_KEYInvalid API key.
ERRORGeneral server error.
Node.js example
const axios = require('axios');

async function getBalance() {
  try {
    const response = await axios.get('https://heyalex.store/stubs/handler_api.php', {
      params: {
        api_key: 'YOUR_API_KEY',
        action: 'getBalance'
      }
    });
    console.log(response.data);
  } catch (error) {
    console.error(error);
  }
}

getBalance();
GET
📡 Get Operators

Retrieve all available network operators

https://heyalex.store/stubs/handler_api.php?api_key=$api_key&action=getOperators
{
  "Operator 1": "1",
  "Operator 2": "2",
  "Any": "any"
}
CodeDescription
BAD_ACTIONInvalid action.
TOO_MANY_REQUESTSRate limit exceeded.
GET
📱 Request a Number

Get a virtual phone number for SMS verification

https://heyalex.store/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&country=$country&operator=$operator
FieldRequiredDescription
serviceYesService ID (e.g. wa).
countryYesCountry ID (e.g. 91).
operatorNoNetwork operator ID.
maxPriceNoMandatory for operator 6 & 9.
ACCESS_NUMBER:3423423432:914738485900
CodeDescription
NO_NUMBERSNo inventory available.
NO_BALANCEInsufficient balance.
BAD_SERVICEInvalid service code.
GET
✉️ Get SMS Status

Retrieve SMS code from the virtual number

https://heyalex.store/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id
CodeDescription
STATUS_OK:12343SMS received. Code is 12343.
STATUS_WAIT_CODEPending delivery.
CodeDescription
NO_ACTIVATIONInvalid Order ID.
STATUS_CANCELOrder timed out/cancelled.
GET
🔄 Change Status

Update the status of a phone number request (Cancel or Retry)

https://heyalex.store/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id
FieldRequiredDescription
statusYes3 = Request another SMS, 8 = Cancel
idYesActivation Order ID
CodeDescription
ACCESS_CANCELCancellation successful.
ACCESS_RETRY_GETWaiting for next SMS.
GET
🌍 Get Countries

Retrieve all available countries

https://heyalex.store/stubs/handler_api.php?api_key=$api_key&action=getCountries
{
  "1": "Ukraine",
  "91": "India",
  "21": "USA"
}
GET
🛠️ Get Services

Retrieve all available services

https://heyalex.store/stubs/handler_api.php?api_key=$api_key&action=getServices
{
  "wa": "WhatsApp",
  "tg": "Telegram",
  "ig": "Instagram"
}

🔍 API Data Explorer

Instantly lookup live codes, names and prices required for your API requests.