API Sənədləşmə

ACCESS_BALANCE:100.5

{
  "title": "BAD_KEY",
  "details": "Unauthorized"
}

{
  "title": "NO_KEY",
  "details": "Unauthorized"
}

{
  "title": "SERVER_ERROR",
  "details": "Server Gone"
}

Номер куплен

ACCESS_NUMBER:123456:+79001234567

Номеров нет

NO_NUMBERS

{
  "title": "WRONG_MAX_PRICE",
  "details": "The maximum price is less than the permitted price",
  "info": {
    "min": 0.5
  }
}

{
  "title": "BAD_KEY",
  "details": "Unauthorized"
}

{
  "title": "NO_KEY",
  "details": "Unauthorized"
}

{
  "title": "NO_BALANCE",
  "details": "Payment Required"
}

{
  "title": "CHANNELS_LIMIT",
  "details": "You have reached the maximum number of concurrent threads (purchases) allowed for your account. Contact the technical support."
}

{
  "title": "UNPROCESSABLE_ENTITY",
  "details": "Validation failed",
  "info": {
    "field": "service",
    "code": "REQUIRED",
    "message": "Param 'service' is required."
  }
}

{
  "title": "SERVER_ERROR",
  "details": "Server Gone"
}

Номер куплен

{
  "activationId": "123456",
  "phoneNumber": "+79001234567",
  "activationCost": 0.5,
  "currency": 840,
  "countryCode": 123,
  "canGetAnotherSms": true,
  "activationTime": "2026-07-17T12:00:00+00:00",
  "activationEndTime": "2026-07-17T12:20:00+00:00",
  "activationOperator": "any"
}

Номеров нет — приходит строкой

NO_NUMBERS

{
  "title": "WRONG_MAX_PRICE",
  "details": "The maximum price is less than the permitted price",
  "info": {
    "min": 0.5
  }
}

{
  "title": "BAD_KEY",
  "details": "Unauthorized"
}

{
  "title": "NO_KEY",
  "details": "Unauthorized"
}

{
  "title": "NO_BALANCE",
  "details": "Payment Required"
}

{
  "title": "UNPROCESSABLE_ENTITY",
  "details": "Validation failed",
  "info": {
    "field": "service",
    "code": "REQUIRED",
    "message": "Param 'service' is required."
  }
}

{
  "title": "SERVER_ERROR",
  "details": "Server Gone"
}

Ждём SMS

STATUS_WAIT_CODE

Ждём повторную SMS

STATUS_WAIT_RESEND

Код получен

STATUS_OK:123456

Активация отменена

STATUS_CANCEL

{
  "title": "BAD_KEY",
  "details": "Unauthorized"
}

{
  "title": "NO_KEY",
  "details": "Unauthorized"
}

{
  "title": "NOT_FOUND",
  "details": "Activation Not Found"
}

{
  "title": "UNPROCESSABLE_ENTITY",
  "details": "Validation failed",
  "info": {
    "field": "service",
    "code": "REQUIRED",
    "message": "Param 'service' is required."
  }
}

{
  "title": "SERVER_ERROR",
  "details": "Server Gone"
}

Код получен

{
  "verificationType": 1,
  "sms": {
    "dateTime": "2026-07-17 12:05:00",
    "code": "123456",
    "text": "Your code is 123456"
  }
}

SMS ещё нет — приходит строкой

STATUS_WAIT_CODE

{
  "title": "BAD_KEY",
  "details": "Unauthorized"
}

{
  "title": "NO_KEY",
  "details": "Unauthorized"
}

{
  "title": "NOT_FOUND",
  "details": "Activation Not Found"
}

{
  "title": "UNPROCESSABLE_ENTITY",
  "details": "Validation failed",
  "info": {
    "field": "service",
    "code": "REQUIRED",
    "message": "Param 'service' is required."
  }
}

{
  "title": "SERVER_ERROR",
  "details": "Server Gone"
}

status=3

ACCESS_RETRY_GET

status=6

ACCESS_ACTIVATION

status=8

ACCESS_CANCEL

{
  "title": "BAD_STATUS",
  "details": "Wrong status code"
}

{
  "title": "BAD_KEY",
  "details": "Unauthorized"
}

{
  "title": "NO_KEY",
  "details": "Unauthorized"
}

{
  "title": "NOT_FOUND",
  "details": "Activation Not Found"
}

Отменять ещё рано

{
  "title": "EARLY_CANCEL_DENIED",
  "details": "Activation cannot be cancelled at this time. Minimum activation period must pass."
}

Код уже пришёл — отмена невозможна

{
  "title": "OTP_RECEIVED",
  "details": "Cannot terminate activation - OTP has been received on this number"
}

Активация уже завершена

{
  "title": "ACTIVATION_NOT_ACTIVE",
  "details": "Activation is terminated/refunded and Otp cannot be retrieved"
}

{
  "title": "UNPROCESSABLE_ENTITY",
  "details": "Validation failed",
  "info": {
    "field": "service",
    "code": "REQUIRED",
    "message": "Param 'service' is required."
  }
}

{
  "title": "SERVER_ERROR",
  "details": "Server Gone"
}

{
  "title": "BAD_KEY",
  "details": "Unauthorized"
}

{
  "title": "NO_KEY",
  "details": "Unauthorized"
}

{
  "title": "NOT_FOUND",
  "details": "Activation Not Found"
}

{
  "title": "ACTIVATION_NOT_ACTIVE",
  "details": "Activation is terminated/refunded and Otp cannot be retrieved"
}

{
  "title": "SERVER_ERROR",
  "details": "Server Gone"
}

{
  "title": "BAD_KEY",
  "details": "Unauthorized"
}

{
  "title": "NO_KEY",
  "details": "Unauthorized"
}

{
  "title": "NOT_FOUND",
  "details": "Activation Not Found"
}

Отменять ещё рано

{
  "title": "EARLY_CANCEL_DENIED",
  "details": "Activation cannot be cancelled at this time. Minimum activation period must pass."
}

Код уже пришёл

{
  "title": "OTP_RECEIVED",
  "details": "Cannot terminate activation - OTP has been received on this number"
}

{
  "title": "SERVER_ERROR",
  "details": "Server Gone"
}

Цены получены

{
  "123": {
    "tg": {
      "cost": 0.5,
      "count": 200,
      "physicalCount": 200
    }
  }
}

Неизвестный сервис

{
  "status": "false",
  "msg": "service is incorrect"
}

Неизвестная страна

{
  "status": "false",
  "msg": "country is incorrect"
}

Неверный ключ — строкой

BAD_KEY

[
  {
    "id": 123,
    "rus": "Казахстан",
    "eng": "Казахстан",
    "chn": "Казахстан",
    "visible": 1,
    "retry": 1
  }
]

Неверный ключ — строкой

BAD_KEY

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

Неверный ключ — строкой

BAD_KEY

{
  "status": "success",
  "data": [
    {
      "activationId": "123456",
      "serviceCode": "tg",
      "phoneNumber": "+79001234567",
      "activationCost": 0.5,
      "activationStatus": "4",
      "smsCode": null,
      "smsText": null,
      "activationTime": "2026-07-17 12:00:00",
      "discount": "0.00",
      "repeated": "0",
      "countryCode": "123",
      "countryName": "Казахстан",
      "canGetAnotherSms": "1",
      "currency": 840
    }
  ]
}

{
  "title": "BAD_KEY",
  "details": "Unauthorized"
}

{
  "title": "NO_KEY",
  "details": "Unauthorized"
}

{
  "title": "SERVER_ERROR",
  "details": "Server Gone"
}

[
  {
    "id": "123456",
    "date": "2026-07-17 12:00:00",
    "phone": "+79001234567",
    "sms": "Your code is 123456",
    "cost": 0.5,
    "status": "6",
    "currency": 840
  }
]

{
  "title": "BAD_KEY",
  "details": "Unauthorized"
}

{
  "title": "NO_KEY",
  "details": "Unauthorized"
}

{
  "title": "SERVER_ERROR",
  "details": "Server Gone"
}

{
  "data": [
    {
      "id": "1",
      "phoneFrom": "Telegram",
      "code": "123456",
      "text": "Your code is 123456",
      "service": "tg",
      "date": "2026-07-17T12:05:00+00:00",
      "type": "sms"
    }
  ],
  "meta": {
    "total": 1,
    "service": "tg"
  }
}

{
  "title": "BAD_KEY",
  "details": "Unauthorized"
}

{
  "title": "NO_KEY",
  "details": "Unauthorized"
}

{
  "title": "NOT_FOUND",
  "details": "Activation Not Found"
}

{
  "title": "ACTIVATION_NOT_ACTIVE",
  "details": "Activation is terminated/refunded and Otp cannot be retrieved"
}

{
  "title": "SERVER_ERROR",
  "details": "Server Gone"
}