Разработчикам

Документация API

Заказывайте номера, получайте коды и управляйте арендой из своего кода. API использует тот же баланс и те же цены, что и личный кабинет, — для всех продуктов.

REST и JSON по HTTPS
Bearer-токен с API-ключом
Callback-уведомления с повторами
100 запросов в минуту
Те же цены, что в личном кабинете

Начало работы

Всё, что нужно до первого запроса: адрес, аутентификация, формат ответов и возможные ошибки.

Базовый URL

https://textverification.io/api/v1/users

Аутентификация

Передавайте API-ключ как Bearer-токен: Authorization: Bearer YOUR_API_KEY. Сгенерируйте ключ в настройках аккаунта и храните его на своём сервере: любой, у кого он есть, может тратить ваш баланс.

Запросы и ответы

Отправляйте тело запроса в формате JSON (поля формы тоже подойдут). Каждый ответ — JSON с полями statusCode, success, message и data; цены указаны в долларах США в виде строк с двумя знаками после запятой.

Быстрый старт

Закажите номер Pinpoint и получите его код. Все остальные продукты работают так же.

cURL

curl -X POST "https://textverification.io/api/v1/users/request-s2-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"1fe58df2"}'

Node.js

const API = "https://textverification.io/api/v1/users";
const headers = {
  Authorization: `Bearer ${process.env.API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Order a number
const order = await fetch(`${API}/request-s2-service`, {
  method: "POST",
  headers,
  body: JSON.stringify({ serviceId: "1fe58df2" }),
}).then((res) => res.json());

// 2. Read the order (or set a callback URL instead of polling)
const { data } = await fetch(
  `${API}/number-details-s2?orderId=${order.data.orderId}`,
  { headers }
).then((res) => res.json());

Python

import os, requests

API = "https://textverification.io/api/v1/users"
headers = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

# 1. Order a number
order = requests.post(f"{API}/request-s2-service",
                      json={"serviceId": "1fe58df2"}, headers=headers).json()

# 2. Read the order (or set a callback URL instead of polling)
details = requests.get(f"{API}/number-details-s2",
                       params={"orderId": order["data"]["orderId"]},
                       headers=headers).json()
print(details["data"]["status"], details["data"]["pin"])

Ошибки

Статус	Описание
400	Некорректный запрос, или на балансе недостаточно средств для заказа.
401	API-ключ отсутствует, недействителен или неактивен.
403	Сейчас это действие недоступно: например, слишком много открытых заказов или аккаунт ограничен.
404	Заказ или сервис не существует либо не принадлежит вам.
409	Заказ сейчас нельзя изменить (он уже завершён или отменён), или его цена только что изменилась.
422	Недопустимый параметр, например неизвестный код региона или срок аренды.
429	Слишком много запросов: снизьте частоту и повторите чуть позже.
503	Продукт сейчас недоступен. Повторите попытку позже или используйте другой продукт.

Используйте callback-уведомления вместо опроса: они приходят на ваш сервер в момент получения кода. Если всё же опрашиваете заказ, делайте паузу в несколько секунд между запросами.

Лимиты запросов

С каждого IP-адреса можно отправлять до 100 запросов в минуту, а с каждого API-ключа — до 600 в минуту со всех адресов вместе. Каждый ответ содержит заголовки RateLimit-Remaining и RateLimit-Reset. На запрос сверх лимита приходит ответ 429 с заголовком Retry-After, в котором указано, сколько секунд подождать. С callback-уведомлениями вы будете укладываться в лимит с большим запасом.

Безопасность интеграции

Храните API-ключ на своём сервере — никогда в мобильном приложении, в коде для браузера или в публичном репозитории.
Если ключ мог утечь, сгенерируйте новый в настройках аккаунта. Старый ключ сразу перестанет работать.
Callback URL должен использовать HTTPS. Добавьте в путь трудноугадываемый токен и, прежде чем обрабатывать уведомление, проверяйте, что orderId относится к заказу, который сделали вы.
Ключ тратит ваш баланс: проверяйте его через эндпоинт баланса и пополняйте перед крупными сериями заказов.

Проверить баланс

Возвращает баланс аккаунта в долларах США.

GET/balance

Пример запроса

curl "https://textverification.io/api/v1/users/balance" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": "120.50",
  "message": "Request Successful!",
  "success": true
}

Prime

Номера США с выбором штата и премиум-запросы для сервисов, номеров для которых сейчас нет в наличии.

Список сервисов и цен

Возвращает сервисы продукта Prime и вашу цену на каждый с учётом скидки.

GET/server1-pricing

Пример запроса

curl "https://textverification.io/api/v1/users/server1-pricing" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "2264119e",
      "serviceName": "WhatsApp",
      "price": "1.30"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Узнать цену сервиса с параметрами

Возвращает вашу цену на один сервис с параметрами, с которыми вы собираетесь его заказать.

GET/server1-price

Параметр	Тип	Обязательный	Описание
serviceId	string	Да	ID сервиса из списка сервисов.
areaCode	string	Нет	Трёхзначный код региона США, например "212", чтобы получить номер с этим кодом. Имеет приоритет над штатом и может увеличить цену.
requestPremium	number	Нет	Премия для сервисов, номеров для которых нет в наличии: заказ ждёт в статусе pending и получает номер, как только тот появится.

Пример запроса

curl "https://textverification.io/api/v1/users/server1-price?serviceId=2264119e&areaCode=212&requestPremium=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "serviceId": "2264119e",
    "serviceName": "WhatsApp",
    "areaCode": "212",
    "requestPremium": 20,
    "price": "1.56"
  },
  "message": "Request Successful!",
  "success": true
}

Список штатов США

Возвращает штаты США, которые можно запросить.

GET/us-states

Пример запроса

curl "https://textverification.io/api/v1/users/us-states" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "CA": "CA",
    "FL": "FL",
    "NY": "NY",
    "TX": "TX"
  },
  "message": "Request Successful!",
  "success": true
}

Заказать номер

Заказывает номер продукта Prime для сервиса и списывает оплату с баланса.

POST/request-s1-service

Параметр	Тип	Обязательный	Описание
serviceId	string	Да	ID сервиса из списка сервисов.
state	string	Нет	Код штата США, например "NY", чтобы получить номер из этого штата.
areaCode	string	Нет	Трёхзначный код региона США, например "212", чтобы получить номер с этим кодом. Имеет приоритет над штатом и может увеличить цену.
requestPremium	number	Нет	Премия для сервисов, номеров для которых нет в наличии: заказ ждёт в статусе pending и получает номер, как только тот появится.

С премией заказ на отсутствующий номер ждёт в статусе pending; когда он получит номер, вам придёт callback s1_win_premium_request.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/request-s1-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"2264119e","state":"NY"}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "55655059",
    "number": "12125550101",
    "serviceName": "WhatsApp",
    "status": "reserved",
    "state": "NY",
    "areaCode": "",
    "requestPremium": 0,
    "price": "1.30",
    "expiredIn": 900
  },
  "message": "Request Successful!",
  "success": true
}

Получить заказ

Возвращает заказ с его статусом, а когда код придёт — и с кодом.

GET/number-details-s1

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl "https://textverification.io/api/v1/users/number-details-s1?orderId=55655059" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "55655059",
    "number": "12125550101",
    "serviceName": "WhatsApp",
    "country": "United States",
    "state": "NY",
    "areaCode": "",
    "price": "1.30",
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

Использовать номер повторно

Снова заказывает тот же номер для ещё одного кода, если сервис это позволяет.

POST/reuse-s1-service

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/reuse-s1-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"55655059"}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "55655059",
    "number": "12125550101",
    "serviceName": "WhatsApp",
    "country": "United States",
    "state": "NY",
    "areaCode": "",
    "price": "1.30",
    "status": "reserved",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

Отменить номер

Отменяет номер, на который ещё не пришёл код, и возвращает его стоимость на баланс.

POST/reject-s1-service

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/reject-s1-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"55655059"}'

Пример ответа

{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Pinpoint

Номера США с выбранными вами кодами регионов и операторами; код приходит по SMS или, где доступно, голосовым звонком.

Список сервисов и цен

Возвращает сервисы продукта Pinpoint и вашу цену на каждый с учётом скидки.

GET/server2-pricing

Пример запроса

curl "https://textverification.io/api/v1/users/server2-pricing" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "1fe58df2",
      "serviceName": "google"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Узнать цену сервиса с параметрами

Возвращает вашу цену на один сервис с параметрами, с которыми вы собираетесь его заказать.

GET/server2-price

Параметр	Тип	Обязательный	Описание
serviceId	string	Да	ID сервиса из списка сервисов.
areas	string	Нет	Коды регионов на выбор через запятую (до 10), например "212,646". Повышают цену.
carrier	string	Нет	Операторы на выбор через запятую: tmo (T-Mobile), vz (Verizon), att (AT&T). Повышают цену.
capability	string	Нет	"sms" (по умолчанию) или "voice", чтобы получить код звонком там, где доступны голосовые звонки.

Пример запроса

curl "https://textverification.io/api/v1/users/server2-price?serviceId=1fe58df2&areas=212%2C646&carrier=vz" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "serviceName": "google",
    "price": "1.53",
    "capability": "sms",
    "areaCode": true,
    "carrier": true
  },
  "message": "Request Successful!",
  "success": true
}

Список кодов регионов

Возвращает коды регионов США, которые можно запросить, с их штатами.

GET/server2-area-codes

Пример запроса

curl "https://textverification.io/api/v1/users/server2-area-codes" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": [
    {
      "areaCode": "212",
      "state": "New York"
    },
    {
      "areaCode": "503",
      "state": "Oregon"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Заказать номер

Заказывает номер продукта Pinpoint для сервиса и списывает оплату с баланса.

POST/request-s2-service

Параметр	Тип	Обязательный	Описание
serviceId	string	Да	ID сервиса из списка сервисов.
areas	string	Нет	Коды регионов на выбор через запятую (до 10), например "212,646". Повышают цену.
carrier	string	Нет	Операторы на выбор через запятую: tmo (T-Mobile), vz (Verizon), att (AT&T). Повышают цену.
capability	string	Нет	"sms" (по умолчанию) или "voice", чтобы получить код звонком там, где доступны голосовые звонки.

Звонки голосовых заказов (capability "voice") принимаются через Voice SDK от Twilio с токеном из эндпоинта токена для звонка. Заказ завершается, когда поступает звонок, и этот звонок появляется в данных заказа.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/request-s2-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"1fe58df2","areas":"212,646","carrier":"vz,att"}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "lr_01K7ABC",
    "number": "12125550102",
    "serviceName": "google",
    "status": "reserved",
    "areas": "212,646",
    "carrier": "vz,att",
    "capability": "sms",
    "price": "1.53",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

Получить заказ

Возвращает заказ с его статусом, а когда код придёт — и с кодом.

GET/number-details-s2

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl "https://textverification.io/api/v1/users/number-details-s2?orderId=lr_01K7ABC" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "lr_01K7ABC",
    "number": "12125550102",
    "serviceName": "google",
    "country": "United States",
    "areas": "212,646",
    "carrier": "vz,att",
    "capability": "sms",
    "price": "1.53",
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

Использовать номер повторно

Снова заказывает тот же номер для ещё одного кода, если сервис это позволяет.

POST/reuse-s2-service

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/reuse-s2-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"lr_01K7ABC"}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "lr_01K7ABC",
    "number": "12125550102",
    "serviceName": "google",
    "country": "United States",
    "areas": "212,646",
    "carrier": "vz,att",
    "capability": "sms",
    "price": "1.53",
    "status": "reserved",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

Отменить номер

Отменяет номер, на который ещё не пришёл код, и возвращает его стоимость на баланс.

POST/reject-s2-service

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/reject-s2-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"lr_01K7ABC"}'

Пример ответа

{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Получить токен для звонка

Возвращает краткосрочный токен, чтобы принять звонок голосового заказа через Voice SDK от Twilio.

GET/s2-voice-token

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl "https://textverification.io/api/v1/users/s2-voice-token?orderId=lr_01K7ABC" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "lr_01K7ABC",
    "token": "eyJhbGciOi…",
    "expiresIn": 540
  },
  "message": "Request Successful!",
  "success": true
}

Скачать запись звонка

Возвращает запись звонка голосового заказа, если она сохранилась.

GET/s2-voice-recording

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.
callId	string	Да	ID звонка из списка звонков заказа.

Пример запроса

curl "https://textverification.io/api/v1/users/s2-voice-recording?orderId=lr_01K7ABC&callId=call_8f2" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

(audio file)

Flex

Несколько кодов регионов и оператор в одном заказе — в США и других доступных странах.

Список сервисов и цен

Возвращает сервисы продукта Flex и вашу цену на каждый с учётом скидки.

GET/server3-pricing

Параметр	Тип	Обязательный	Описание
country	string	Нет	Код страны из списка стран. Не указывайте его для США (или первой страны в продаже).

Пример запроса

curl "https://textverification.io/api/v1/users/server3-pricing" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "9a1c55e0",
      "serviceName": "Telegram",
      "price": "0.40"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Список стран

Возвращает страны, в которых доступны номера продукта Flex, с их кодами.

GET/server3-countries

Пример запроса

curl "https://textverification.io/api/v1/users/server3-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": [
    {
      "code": "us",
      "name": "United States"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Заказать номер

Заказывает номер продукта Flex для сервиса и списывает оплату с баланса.

POST/request-s3-service

Параметр	Тип	Обязательный	Описание
serviceId	string	Да	ID сервиса из списка сервисов.
areas	string	Нет	Коды регионов через запятую (до 10). Повышают цену.
carrier	string	Нет	"att" или "tmo". Повышает цену.
country	string	Нет	Код страны из списка стран. Не указывайте его для США (или первой страны в продаже).

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/request-s3-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"9a1c55e0","areas":"212,646","carrier":"tmo"}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "48211973",
    "number": "16465550103",
    "serviceName": "Telegram",
    "country": "United States",
    "status": "reserved",
    "areas": "212,646",
    "carrier": "tmo",
    "price": "0.58",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

Получить заказ

Возвращает заказ с его статусом, а когда код придёт — и с кодом.

GET/number-details-s3

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl "https://textverification.io/api/v1/users/number-details-s3?orderId=48211973" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "48211973",
    "number": "16465550103",
    "serviceName": "Telegram",
    "country": "United States",
    "price": "0.58",
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

Использовать номер повторно

Снова заказывает тот же номер для ещё одного кода, если сервис это позволяет.

POST/reuse-s3-service

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/reuse-s3-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"48211973"}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "48211973",
    "number": "16465550103",
    "serviceName": "Telegram",
    "country": "United States",
    "price": "0.58",
    "status": "reserved",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

Отменить номер

Отменяет номер, на который ещё не пришёл код, и возвращает его стоимость на баланс.

POST/reject-s3-service

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/reject-s3-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"48211973"}'

Пример ответа

{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Global

Номера из многих стран: получите список стран, затем закажите номер для сервиса в одной из них.

Список сервисов и цен

Возвращает сервисы продукта Global и вашу цену на каждый с учётом скидки.

GET/server4-pricing

Параметр	Тип	Обязательный	Описание
country	string	Нет	Код страны из списка стран. Не указывайте его для США (или первой страны в продаже).

Пример запроса

curl "https://textverification.io/api/v1/users/server4-pricing?country=gb" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "c41e7a02",
      "serviceName": "WhatsApp",
      "price": "0.35"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Список стран

Возвращает страны, в которых доступны номера продукта Global, с их кодами.

GET/server4-countries

Пример запроса

curl "https://textverification.io/api/v1/users/server4-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": [
    {
      "code": "us",
      "name": "United States"
    },
    {
      "code": "gb",
      "name": "United Kingdom"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Параметры подтверждения и оператора

Показывает, можно ли подтвердить сервис через FlashCall + SMS в стране, и операторов, от которых могут быть номера, с ценой каждого варианта.

GET/server4-options

Параметр	Тип	Обязательный	Описание
serviceId	string	Да	ID сервиса из списка сервисов.
country	string	Нет	Код страны из списка стран. Не указывайте его для США (или первой страны в продаже).

Пример запроса

curl "https://textverification.io/api/v1/users/server4-options?serviceId=c41e7a02&country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "price": "2.70",
    "call": {
      "price": "3.00"
    },
    "carriers": {
      "surcharge": 20,
      "operators": [
        {
          "code": "at_t",
          "name": "AT&T"
        },
        {
          "code": "tmobile",
          "name": "T-Mobile"
        },
        {
          "code": "verizon",
          "name": "Verizon"
        }
      ],
      "price": "3.24",
      "callPrice": "3.60"
    }
  },
  "message": "Request Successful!",
  "success": true
}

Заказать номер

Заказывает номер продукта Global для сервиса и списывает оплату с баланса.

POST/request-s4-service

Параметр	Тип	Обязательный	Описание
serviceId	string	Да	ID сервиса из списка сервисов.
country	string	Нет	Код страны из списка стран. Не указывайте его для США (или первой страны в продаже).
verification	string	Нет	"call" для FlashCall + SMS: сервис звонит на номер, и номер звонящего — это код. По умолчанию "sms".
operator	string	Нет	Код оператора из эндпоинта параметров, чтобы получить номер только этого оператора. Добавляет надбавку за оператора. По умолчанию — любой оператор.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/request-s4-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"c41e7a02","country":"us","operator":"tmobile"}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "3311842",
    "number": "12125550142",
    "serviceName": "WhatsApp",
    "country": "United States",
    "status": "reserved",
    "price": "3.24",
    "expiredIn": 1200,
    "carrier": "T-Mobile"
  },
  "message": "Request Successful!",
  "success": true
}

Получить заказ

Возвращает заказ с его статусом, а когда код придёт — и с кодом.

GET/number-details-s4

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl "https://textverification.io/api/v1/users/number-details-s4?orderId=3311842" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "3311842",
    "number": "12125550142",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "3.24",
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

Использовать номер повторно

Снова заказывает тот же номер для ещё одного кода, если сервис это позволяет.

POST/reuse-s4-service

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/reuse-s4-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"3311842"}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "3311842",
    "number": "12125550142",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "3.24",
    "status": "reserved",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

Отменить номер

Отменяет номер, на который ещё не пришёл код, и возвращает его стоимость на баланс.

POST/reject-s4-service

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/reject-s4-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"3311842"}'

Пример ответа

{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Smart

Недорогие номера из многих стран — с кодами регионов, приоритетом и до 5 номеров за один запрос.

Список сервисов и цен

Возвращает сервисы продукта Smart и вашу цену на каждый с учётом скидки.

GET/server5-pricing

Параметр	Тип	Обязательный	Описание
country	string	Нет	Код страны из списка стран. Не указывайте его для США (или первой страны в продаже).

Пример запроса

curl "https://textverification.io/api/v1/users/server5-pricing" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "7d0f3b11",
      "serviceName": "Telegram",
      "price": "0.12"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Список стран

Возвращает страны, в которых доступны номера продукта Smart, с их кодами.

GET/server5-countries

Пример запроса

curl "https://textverification.io/api/v1/users/server5-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": [
    {
      "code": "us",
      "name": "United States"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Параметры заказа

Возвращает коды регионов, доступные для сервиса в стране, и их надбавку к цене.

GET/server5-options

Параметр	Тип	Обязательный	Описание
serviceId	string	Да	ID сервиса из списка сервисов.
country	string	Нет	Код страны из списка стран. Не указывайте его для США (или первой страны в продаже).

Пример запроса

curl "https://textverification.io/api/v1/users/server5-options?serviceId=7d0f3b11&country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "price": "0.12",
    "successRate": 61,
    "bestSuccess": {
      "price": "0.15",
      "successRate": 84
    },
    "areaCodes": {
      "surcharge": 20,
      "lines": [
        {
          "price": "0.17",
          "successRate": 84,
          "codes": [
            "212",
            "646"
          ]
        }
      ]
    }
  },
  "message": "Request Successful!",
  "success": true
}

Заказать номер

Заказывает номер продукта Smart для сервиса и списывает оплату с баланса.

POST/request-s5-service

Параметр	Тип	Обязательный	Описание
serviceId	string	Да	ID сервиса из списка сервисов.
country	string	Нет	Код страны из списка стран. Не указывайте его для США (или первой страны в продаже).
areaCodes	string[]	Нет	Коды регионов, которые нужно получить или — с excludeAreaCodes — избежать: списком или через запятую, до 10. Повышают цену.
excludeAreaCodes	boolean	Нет	true, чтобы избегать этих кодов регионов, а не получать номер с одним из них.
priority	string	Нет	"price" (по умолчанию) — самая низкая цена, или "success" — линия, которая вернее всего доставит ваш код.
quantity	number	Нет	Сколько номеров заказать за раз, от 1 до 5. Каждый номер становится отдельным заказом.
phoneNumber	string	Нет	Конкретный номер, который был у вас раньше (цифры с кодом страны), если он снова свободен.

Если quantity больше 1, в ответе перечислены все размещённые заказы; если удалось заказать меньше, указано, сколько и почему.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/request-s5-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"7d0f3b11","areaCodes":["212"],"priority":"success"}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "AB12CD34",
    "number": "12125550105",
    "serviceName": "Telegram",
    "country": "United States",
    "status": "reserved",
    "price": "0.14",
    "expiredIn": 1200
  },
  "message": "Request Successful!",
  "success": true
}

Получить заказ

Возвращает заказ с его статусом, а когда код придёт — и с кодом.

GET/number-details-s5

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl "https://textverification.io/api/v1/users/number-details-s5?orderId=AB12CD34" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "AB12CD34",
    "number": "12125550105",
    "serviceName": "Telegram",
    "country": "United States",
    "price": "0.14",
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

Использовать номер повторно

Снова заказывает тот же номер для ещё одного кода, если сервис это позволяет.

POST/reuse-s5-service

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/reuse-s5-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"AB12CD34"}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "AB12CD34",
    "number": "12125550105",
    "serviceName": "Telegram",
    "country": "United States",
    "price": "0.14",
    "status": "reserved",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

Отменить номер

Отменяет номер, на который ещё не пришёл код, и возвращает его стоимость на баланс.

POST/reject-s5-service

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/reject-s5-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"AB12CD34"}'

Пример ответа

{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Plus

Номера из многих стран, у каждого сервиса несколько линий: заказывайте самую дешёвую, выбирайте линию или ограничивайте цену.

Список сервисов и цен

Возвращает сервисы продукта Plus и вашу цену на каждый с учётом скидки.

GET/server6-pricing

Параметр	Тип	Обязательный	Описание
country	string	Нет	Код страны из списка стран. Не указывайте его для США (или первой страны в продаже).

Пример запроса

curl "https://textverification.io/api/v1/users/server6-pricing?country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "5b2c9e41",
      "serviceName": "WhatsApp",
      "price": "0.68"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Список стран

Возвращает страны, в которых доступны номера продукта Plus, с их кодами.

GET/server6-countries

Пример запроса

curl "https://textverification.io/api/v1/users/server6-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": [
    {
      "code": "us",
      "name": "United States"
    },
    {
      "code": "gb",
      "name": "United Kingdom"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Список линий и цен

Возвращает линии, через которые сервис продаётся в стране, от самой дешёвой, с вашей ценой для каждой и её процентом успеха, когда он известен.

GET/server6-options

Параметр	Тип	Обязательный	Описание
serviceId	string	Да	ID сервиса из списка сервисов.
country	string	Нет	Код страны из списка стран. Не указывайте его для США (или первой страны в продаже).

Пример запроса

curl "https://textverification.io/api/v1/users/server6-options?serviceId=5b2c9e41&country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "price": "0.68",
    "lines": [
      {
        "lineId": "a91f03c2",
        "price": "0.68",
        "successRate": 92
      },
      {
        "lineId": "4e7d2b10",
        "price": "0.68",
        "successRate": null
      },
      {
        "lineId": "c03b5f77",
        "price": "1.08",
        "successRate": 97
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

Заказать номер

Заказывает номер продукта Plus для сервиса и списывает оплату с баланса.

POST/request-s6-service

Параметр	Тип	Обязательный	Описание
serviceId	string	Да	ID сервиса из списка сервисов.
country	string	Нет	Код страны из списка стран. Не указывайте его для США (или первой страны в продаже).
lineId	string	Нет	Линия из списка линий. Не указывайте, чтобы взять самую дешёвую.
maxPrice	number	Нет	Максимум, который вы заплатите, в долларах США. Более высокая цена отклоняется; без lineId может использоваться любая линия до этой цены.

Без lineId используется самая дешёвая линия, а если в ней нет номеров — другая линия по той же цене. Если линия не доставляет коды для сервиса, отклоните номер и закажите через другую lineId.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/request-s6-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"5b2c9e41","country":"us","maxPrice":0.7}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "230698",
    "number": "15551230456",
    "serviceName": "WhatsApp",
    "country": "United States",
    "status": "reserved",
    "price": "0.68",
    "expiredIn": 1200,
    "lineId": "a91f03c2"
  },
  "message": "Request Successful!",
  "success": true
}

Получить заказ

Возвращает заказ с его статусом, а когда код придёт — и с кодом.

GET/number-details-s6

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl "https://textverification.io/api/v1/users/number-details-s6?orderId=230698" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "230698",
    "number": "15551230456",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "0.68",
    "lineId": "a91f03c2",
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

Использовать номер повторно

Снова заказывает тот же номер для ещё одного кода, если сервис это позволяет.

POST/reuse-s6-service

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/reuse-s6-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"230698"}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "230698",
    "number": "15551230456",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "0.68",
    "lineId": "a91f03c2",
    "status": "reserved",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

Отменить номер

Отменяет номер, на который ещё не пришёл код, и возвращает его стоимость на баланс.

POST/reject-s6-service

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/reject-s6-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"230698"}'

Пример ответа

{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Express

Номера США для быстрого кода: закажите номер для сервиса и получите код в деталях заказа или по callback в течение 5 минут жизни номера.

Список сервисов и цен

Возвращает сервисы продукта Express и вашу цену на каждый с учётом скидки.

GET/server7-pricing

Пример запроса

curl "https://textverification.io/api/v1/users/server7-pricing" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "3e7a91c0",
      "serviceName": "WhatsApp",
      "price": "0.75",
      "multiplePrice": "1.13",
      "smsModes": [
        "single",
        "multiple"
      ]
    },
    {
      "serviceId": "8b2c40d1",
      "serviceName": "Telegram",
      "price": "0.50",
      "multiplePrice": null,
      "smsModes": [
        "single"
      ]
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Заказать номер

Заказывает номер продукта Express для сервиса и списывает оплату с баланса.

POST/request-s7-service

Параметр	Тип	Обязательный	Описание
serviceId	string	Да	ID сервиса из списка сервисов.
smsMode	string	Нет	"multiple" — все SMS, отправленные на номер, пока он активен (5 минут), каждое доставляется сразу, по multiplePrice сервиса. Только для сервисов, у которых smsModes содержит "multiple". По умолчанию "single" или "multiple" для сервиса, который продаётся только так.

Номер Express активен 5 минут. Если за это время код не придёт, заказ отменяется, а деньги возвращаются автоматически. Номера Express нельзя использовать повторно. С smsMode "multiple" номер принимает коды все 5 минут: каждый новый код отправляет ещё один callback s7_otp_received, а в деталях заказа перечислены все коды, последний — в pin.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/request-s7-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"3e7a91c0","smsMode":"multiple"}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "9f2c41ab07d3e815",
    "number": "12125550142",
    "serviceName": "WhatsApp",
    "country": "United States",
    "status": "reserved",
    "price": "1.13",
    "expiredIn": 300,
    "smsMode": "multiple"
  },
  "message": "Request Successful!",
  "success": true
}

Получить заказ

Возвращает заказ с его статусом, а когда код придёт — и с кодом.

GET/number-details-s7

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl "https://textverification.io/api/v1/users/number-details-s7?orderId=9f2c41ab07d3e815" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "9f2c41ab07d3e815",
    "number": "12125550142",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "1.13",
    "smsMode": "multiple",
    "codes": [
      {
        "code": "318204",
        "message": "Your code is 318204",
        "receivedAt": "2026-10-09 12:44:00"
      },
      {
        "code": "482910",
        "message": "Your code is 482910",
        "receivedAt": "2026-10-09 12:44:00"
      }
    ],
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

Отменить номер

Отменяет номер, на который ещё не пришёл код, и возвращает его стоимость на баланс.

POST/reject-s7-service

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/reject-s7-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"9f2c41ab07d3e815"}'

Пример ответа

{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Аренда Pinpoint

Номер США для одного сервиса на срок от 1 дня до года, с продлением и автопродлением.

Список сервисов аренды и цен

Возвращает сервисы продукта Аренда Pinpoint и вашу цену на каждый срок аренды.

GET/rental-services

Пример запроса

curl "https://textverification.io/api/v1/users/rental-services" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "rg5e1d20",
      "serviceName": "whatsapp"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Узнать цену аренды

Возвращает вашу цену на каждый срок аренды для одного сервиса — с кодами регионов или без них.

GET/rental-prices

Параметр	Тип	Обязательный	Описание
serviceId	string	Да	ID сервиса из списка сервисов.
areas	string	Нет	Коды регионов через запятую (до 10). Повышают цену.

Не каждый сервис доступен на любой срок: этот эндпоинт возвращает сроки, на которые можно арендовать номер для сервиса.

Пример запроса

curl "https://textverification.io/api/v1/users/rental-prices?serviceId=rg5e1d20" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": [
    {
      "label": "oneDay",
      "days": 1,
      "price": "2.85"
    },
    {
      "label": "thirtyDay",
      "days": 30,
      "price": "7.20"
    },
    {
      "label": "oneYear",
      "days": 365,
      "price": "72.00"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Арендовать номер

Арендует номер продукта Аренда Pinpoint для сервиса и списывает с баланса оплату за весь срок.

POST/request-rental

Параметр	Тип	Обязательный	Описание
serviceId	string	Да	ID сервиса из списка сервисов.
duration	string	Да	Срок аренды: oneDay, threeDay, sevenDay, fourteenDay, thirtyDay, ninetyDay или oneYear.
areas	string	Нет	Коды регионов через запятую (до 10). Повышают цену.
autoRenew	boolean	Нет	true, чтобы продлевать аренду с баланса за несколько часов до окончания.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/request-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"rg5e1d20","duration":"thirtyDay","autoRenew":true}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "7.20",
    "status": "reserved",
    "canRefund": true,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "thirtyDay",
    "duration": 30,
    "renewals": 0
  },
  "message": "Request Successful!",
  "success": true
}

Прочитать сообщения аренды

Возвращает сообщения, полученные арендованным номером, начиная с новых.

GET/rental-messages

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.
page / limit	number	Нет	Номер страницы и размер страницы (до 100).

Пример запроса

curl "https://textverification.io/api/v1/users/rental-messages?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "messages": [
      {
        "id": "66f0a1",
        "orderId": "6702f1c4e2",
        "number": "12125550104",
        "service": "WhatsApp",
        "sender": "WhatsApp",
        "message": "Your WhatsApp code: 551-204",
        "pin": "551204",
        "timestamp": "2026-10-09 12:44:00"
      }
    ],
    "pagination": {
      "total": 1,
      "page": 1,
      "limit": 10,
      "totalPages": 1
    }
  },
  "message": "Request Successful!",
  "success": true
}

Узнать цены продления

Возвращает сроки, на которые можно продлить действующую аренду, и вашу цену на каждый.

GET/rental-renew-options

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl "https://textverification.io/api/v1/users/rental-renew-options?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "whatsapp",
    "periods": [
      {
        "period": "thirtyDay",
        "days": 30,
        "price": "7.20"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

Продлить аренду

Продлевает действующую аренду и списывает оплату с баланса. Если срок не указан, аренда продлевается на свой исходный срок.

POST/renew-rental

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.
period	string	Нет	Срок продления (те же значения, что и у duration). Не указывайте, чтобы продлить на исходный срок аренды.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/renew-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","period":"thirtyDay"}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "14.40",
    "status": "reserved",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "thirtyDay",
    "duration": 30,
    "renewals": 1
  },
  "message": "Request Successful!",
  "success": true
}

Включить или отключить автопродление

Определяет, будет ли действующая аренда продлеваться с баланса за несколько часов до окончания.

POST/rental-auto-renew

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.
enabled	boolean	Да	true — включить автопродление, false — отключить.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/rental-auto-renew" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","enabled":false}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "autoRenew": false
  },
  "message": "Request Successful!",
  "success": true
}

Отменить аренду

Отменяет аренду, за которую ещё можно вернуть деньги (до первого сообщения), и возвращает её стоимость на баланс.

POST/release-rental

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/release-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2"}'

Пример ответа

{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Аренда Flex

Номер США на срок от 1 до 30 дней, с автопродлением и возвратом истёкших номеров.

Список сервисов аренды и цен

Возвращает сервисы продукта Аренда Flex и вашу цену на каждый срок аренды.

GET/s3-rental-services

Параметр	Тип	Обязательный	Описание
country	string	Нет	Код страны из списка стран. Не указывайте его для США (или первой страны в продаже).

Пример запроса

curl "https://textverification.io/api/v1/users/s3-rental-services" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "1f3aa214",
      "serviceName": "Amazon",
      "prices": [
        {
          "period": "1d",
          "days": 1,
          "price": "2.88"
        },
        {
          "period": "30d",
          "days": 30,
          "price": "5.76"
        }
      ]
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Список стран

Возвращает страны, в которых доступны номера продукта Аренда Flex, с их кодами.

GET/s3-rental-countries

Пример запроса

curl "https://textverification.io/api/v1/users/s3-rental-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": [
    {
      "code": "us",
      "name": "United States"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Арендовать номер

Арендует номер продукта Аренда Flex для сервиса и списывает с баланса оплату за весь срок.

POST/request-s3-rental

Параметр	Тип	Обязательный	Описание
serviceId	string	Да	ID сервиса из списка сервисов.
period	string	Да	Срок аренды из списка сервисов, например "7d".
areas	string	Нет	Коды регионов через запятую (до 10). Повышают цену.
autoRenew	boolean	Нет	true, чтобы продлевать аренду с баланса за несколько часов до окончания.
country	string	Нет	Код страны из списка стран. Не указывайте его для США (или первой страны в продаже).

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/request-s3-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"1f3aa214","period":"7d","autoRenew":true}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "3.20",
    "status": "reserved",
    "canRefund": true,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "7d",
    "duration": 7,
    "renewPrice": "3.20"
  },
  "message": "Request Successful!",
  "success": true
}

Получить аренду

Возвращает аренду с её статусом, датой окончания и настройками продления.

GET/s3-rental-details

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl "https://textverification.io/api/v1/users/s3-rental-details?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "3.20",
    "status": "active",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "7d",
    "duration": 7
  },
  "message": "Request Successful!",
  "success": true
}

Прочитать сообщения аренды

Возвращает сообщения, полученные арендованным номером, начиная с новых.

GET/s3-rental-messages

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.
page / limit	number	Нет	Номер страницы и размер страницы (до 100).

Пример запроса

curl "https://textverification.io/api/v1/users/s3-rental-messages?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "messages": [
      {
        "id": "66f0a1",
        "orderId": "6702f1c4e2",
        "number": "12125550104",
        "service": "WhatsApp",
        "sender": "WhatsApp",
        "message": "Your WhatsApp code: 551-204",
        "pin": "551204",
        "timestamp": "2026-10-09 12:44:00"
      }
    ],
    "pagination": {
      "total": 1,
      "page": 1,
      "limit": 10,
      "totalPages": 1
    }
  },
  "message": "Request Successful!",
  "success": true
}

Продлить аренду

POST/renew-s3-rental

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/renew-s3-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2"}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "6.40",
    "status": "reserved",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "7d",
    "duration": 7
  },
  "message": "Request Successful!",
  "success": true
}

Включить или отключить автопродление

Определяет, будет ли действующая аренда продлеваться с баланса за несколько часов до окончания.

POST/s3-rental-auto-renew

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.
enabled	boolean	Да	true — включить автопродление, false — отключить.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/s3-rental-auto-renew" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","enabled":true}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "autoRenew": true
  },
  "message": "Request Successful!",
  "success": true
}

Отменить аренду

POST/cancel-s3-rental

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/cancel-s3-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2"}'

Пример ответа

{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Узнать цены возврата номера

Возвращает сроки, на которые можно вернуть номер истёкшей аренды, и вашу цену на каждый.

GET/s3-rental-retake-options

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl "https://textverification.io/api/v1/users/s3-rental-retake-options?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "Amazon",
    "periods": [
      {
        "period": "7d",
        "days": 7,
        "price": "4.80"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

Вернуть истёкший номер

Снова арендует номер истёкшей аренды для того же сервиса, пока он свободен.

POST/retake-s3-rental

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.
period	string	Да	Срок аренды из списка сервисов, например "7d".
autoRenew	boolean	Нет	true, чтобы продлевать аренду с баланса за несколько часов до окончания.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/retake-s3-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","period":"7d"}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "6702f9a811",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "4.80",
    "status": "reserved",
    "canRefund": true,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "7d",
    "duration": 7
  },
  "message": "Request Successful!",
  "success": true
}

Аренда Global

Аренда номеров во многих странах: продлевайте на любой доступный срок или включите автопродление.

Список сервисов аренды и цен

Возвращает сервисы продукта Аренда Global и вашу цену на каждый срок аренды.

GET/s4-rental-services

Параметр	Тип	Обязательный	Описание
country	string	Нет	Код страны из списка стран. Не указывайте его для США (или первой страны в продаже).

Пример запроса

curl "https://textverification.io/api/v1/users/s4-rental-services" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "c41e7a02",
      "serviceName": "WhatsApp",
      "prices": [
        {
          "period": "1d",
          "days": 1,
          "price": "0.90"
        },
        {
          "period": "30d",
          "days": 30,
          "price": "9.60"
        }
      ]
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Список стран

Возвращает страны, в которых доступны номера продукта Аренда Global, с их кодами.

GET/s4-rental-countries

Пример запроса

curl "https://textverification.io/api/v1/users/s4-rental-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": [
    {
      "code": "us",
      "name": "United States"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Арендовать номер

Арендует номер продукта Аренда Global для сервиса и списывает с баланса оплату за весь срок.

POST/request-s4-rental

Параметр	Тип	Обязательный	Описание
serviceId	string	Да	ID сервиса из списка сервисов.
period	string	Да	Срок аренды из списка сервисов, например "7d".
autoRenew	boolean	Нет	true, чтобы продлевать аренду с баланса за несколько часов до окончания.
country	string	Нет	Код страны из списка стран. Не указывайте его для США (или первой страны в продаже).

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/request-s4-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"c41e7a02","period":"30d","country":"us"}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "9.60",
    "status": "reserved",
    "canRefund": true,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "30d",
    "duration": 30
  },
  "message": "Request Successful!",
  "success": true
}

Получить аренду

Возвращает аренду с её статусом, датой окончания и настройками продления.

GET/s4-rental-details

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl "https://textverification.io/api/v1/users/s4-rental-details?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "9.60",
    "status": "active",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "30d",
    "duration": 30
  },
  "message": "Request Successful!",
  "success": true
}

Прочитать сообщения аренды

Возвращает сообщения, полученные арендованным номером, начиная с новых.

GET/s4-rental-messages

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.
page / limit	number	Нет	Номер страницы и размер страницы (до 100).

Пример запроса

curl "https://textverification.io/api/v1/users/s4-rental-messages?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "messages": [
      {
        "id": "66f0a1",
        "orderId": "6702f1c4e2",
        "number": "12125550104",
        "service": "WhatsApp",
        "sender": "WhatsApp",
        "message": "Your WhatsApp code: 551-204",
        "pin": "551204",
        "timestamp": "2026-10-09 12:44:00"
      }
    ],
    "pagination": {
      "total": 1,
      "page": 1,
      "limit": 10,
      "totalPages": 1
    }
  },
  "message": "Request Successful!",
  "success": true
}

Узнать цены продления

Возвращает сроки, на которые можно продлить действующую аренду, и вашу цену на каждый.

GET/s4-rental-renew-options

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl "https://textverification.io/api/v1/users/s4-rental-renew-options?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "periods": [
      {
        "period": "30d",
        "days": 30,
        "price": "9.60"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

Продлить аренду

POST/renew-s4-rental

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.
period	string	Нет	Срок продления из списка цен продления. Не указывайте, чтобы продлить на исходный срок аренды.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/renew-s4-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","period":"30d"}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "19.20",
    "status": "reserved",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "30d",
    "duration": 30
  },
  "message": "Request Successful!",
  "success": true
}

Включить или отключить автопродление

Определяет, будет ли действующая аренда продлеваться с баланса за несколько часов до окончания.

POST/s4-rental-auto-renew

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.
enabled	boolean	Да	true — включить автопродление, false — отключить.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/s4-rental-auto-renew" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","enabled":true}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "autoRenew": true
  },
  "message": "Request Successful!",
  "success": true
}

Отменить аренду

POST/cancel-s4-rental

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/cancel-s4-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2"}'

Пример ответа

{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Узнать цены возврата номера

Возвращает сроки, на которые можно вернуть номер истёкшей аренды, и вашу цену на каждый.

GET/s4-rental-retake-options

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl "https://textverification.io/api/v1/users/s4-rental-retake-options?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "periods": [
      {
        "period": "30d",
        "days": 30,
        "price": "9.60"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

Вернуть истёкший номер

Снова арендует номер истёкшей аренды для того же сервиса, пока он свободен.

POST/retake-s4-rental

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.
period	string	Да	Срок аренды из списка сервисов, например "7d".
autoRenew	boolean	Нет	true, чтобы продлевать аренду с баланса за несколько часов до окончания.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/retake-s4-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","period":"30d"}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "6702f9a811",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "9.60",
    "status": "reserved",
    "canRefund": true,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "30d",
    "duration": 30
  },
  "message": "Request Successful!",
  "success": true
}

Аренда Plus

Арендуйте номер страны на месяцы, чтобы получать сообщения всех сервисов, продлевайте его или включите автопродление.

Список стран

Возвращает страны, в которых доступны номера продукта Аренда Plus, с их кодами.

GET/s6-rental-countries

Пример запроса

curl "https://textverification.io/api/v1/users/s6-rental-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": [
    {
      "code": "ca",
      "name": "Canada"
    },
    {
      "code": "us",
      "name": "United States"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

Список сроков аренды и цен

Возвращает сроки, на которые можно арендовать номера Аренда Plus в стране, с вашей ценой для каждого.

GET/s6-rental-plans

Параметр	Тип	Обязательный	Описание
country	string	Нет	Код страны из списка стран. Не указывайте его для США (или первой страны в продаже).

Пример запроса

curl "https://textverification.io/api/v1/users/s6-rental-plans?country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "country": {
      "code": "us",
      "name": "United States"
    },
    "plans": [
      {
        "period": "1m",
        "months": 1,
        "days": 30,
        "price": "7.50"
      },
      {
        "period": "3m",
        "months": 3,
        "days": 90,
        "price": "21.00"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

Арендовать номер

Арендует номер продукта Аренда Plus для сервиса и списывает с баланса оплату за весь срок.

POST/request-s6-rental

Параметр	Тип	Обязательный	Описание
period	string	Да	Срок аренды в месяцах из списка сроков: "1m", "2m", "3m", "6m" или "12m".
autoRenew	boolean	Нет	true, чтобы продлевать аренду с баланса за несколько часов до окончания.
country	string	Нет	Код страны из списка стран. Не указывайте его для США (или первой страны в продаже).

Номер Аренды Plus не привязан к одному сервису: он принимает сообщения от всех сервисов. Аренду можно отменить с возвратом денег в течение 20 минут после начала, до первого сообщения.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/request-s6-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"period":"1m","country":"us","autoRenew":true}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "number": "15143080170",
    "serviceName": "Any service",
    "anyService": true,
    "country": "United States",
    "period": "1m",
    "months": 1,
    "duration": 30,
    "price": "7.50",
    "status": "reserved",
    "canRefund": true,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "remainingTime": 2591940
  },
  "message": "Request Successful!",
  "success": true
}

Получить аренду

Возвращает аренду с её статусом, датой окончания и настройками продления.

GET/s6-rental-details

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl "https://textverification.io/api/v1/users/s6-rental-details?orderId=9c41e2b7" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "number": "15143080170",
    "serviceName": "Any service",
    "anyService": true,
    "country": "United States",
    "period": "1m",
    "months": 1,
    "duration": 30,
    "price": "7.50",
    "status": "active",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "remainingTime": 2591940
  },
  "message": "Request Successful!",
  "success": true
}

Прочитать сообщения аренды

Возвращает сообщения, полученные арендованным номером, начиная с новых.

GET/s6-rental-messages

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.
page / limit	number	Нет	Номер страницы и размер страницы (до 100).

Пример запроса

curl "https://textverification.io/api/v1/users/s6-rental-messages?orderId=9c41e2b7" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "messages": [
      {
        "id": "66f0a1",
        "orderId": "9c41e2b7",
        "number": "15143080170",
        "service": "Any service",
        "sender": "",
        "message": "Your WhatsApp code: 551-204",
        "pin": "551204",
        "timestamp": "2026-10-09 12:44:00"
      }
    ],
    "pagination": {
      "total": 1,
      "page": 1,
      "limit": 10,
      "totalPages": 1
    }
  },
  "message": "Request Successful!",
  "success": true
}

Узнать цены продления

Возвращает сроки, на которые можно продлить действующую аренду, и вашу цену на каждый.

GET/s6-rental-renew-options

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl "https://textverification.io/api/v1/users/s6-rental-renew-options?orderId=9c41e2b7" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "number": "15143080170",
    "serviceName": "Any service",
    "anyService": true,
    "periods": [
      {
        "period": "1m",
        "months": 1,
        "days": 30,
        "price": "7.50"
      },
      {
        "period": "3m",
        "months": 3,
        "days": 90,
        "price": "21.00"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

Продлить аренду

POST/renew-s6-rental

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.
period	string	Нет	Срок продления из цен продления, например "1m". Не указывайте, чтобы продлить на срок самой аренды.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/renew-s6-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"9c41e2b7","period":"3m"}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "number": "15143080170",
    "serviceName": "Any service",
    "anyService": true,
    "country": "United States",
    "period": "1m",
    "months": 1,
    "duration": 30,
    "price": "28.50",
    "status": "reserved",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2027-02-09 12:44:00",
    "remainingTime": 2591940
  },
  "message": "Request Successful!",
  "success": true
}

Включить или отключить автопродление

Определяет, будет ли действующая аренда продлеваться с баланса за несколько часов до окончания.

POST/s6-rental-auto-renew

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.
enabled	boolean	Да	true — включить автопродление, false — отключить.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/s6-rental-auto-renew" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"9c41e2b7","enabled":true}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "autoRenew": true
  },
  "message": "Request Successful!",
  "success": true
}

Отменить аренду

POST/cancel-s6-rental

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/cancel-s6-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"9c41e2b7"}'

Пример ответа

{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Узнать цены возврата номера

Возвращает сроки, на которые можно вернуть номер истёкшей аренды, и вашу цену на каждый.

GET/s6-rental-retake-options

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.

Пример запроса

curl "https://textverification.io/api/v1/users/s6-rental-retake-options?orderId=9c41e2b7" \
  -H "Authorization: Bearer YOUR_API_KEY"

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "number": "15143080170",
    "serviceName": "Any service",
    "anyService": true,
    "periods": [
      {
        "period": "1m",
        "months": 1,
        "days": 30,
        "price": "7.50"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

Вернуть истёкший номер

Снова арендует номер истёкшей аренды для того же сервиса, пока он свободен.

POST/retake-s6-rental

Параметр	Тип	Обязательный	Описание
orderId	string	Да	ID заказа, полученный при заказе.
period	string	Да	Срок аренды в месяцах из списка сроков: "1m", "2m", "3m", "6m" или "12m".
autoRenew	boolean	Нет	true, чтобы продлевать аренду с баланса за несколько часов до окончания.

Повторная активация продлевает ту же аренду с теми же orderId и номером. Это возможно ещё несколько дней после окончания аренды.

Пример запроса

curl -X POST "https://textverification.io/api/v1/users/retake-s6-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"9c41e2b7","period":"1m"}'

Пример ответа

{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "number": "15143080170",
    "serviceName": "Any service",
    "anyService": true,
    "country": "United States",
    "period": "1m",
    "months": 1,
    "duration": 30,
    "price": "15.00",
    "status": "reserved",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "remainingTime": 2591940
  },
  "message": "Request Successful!",
  "success": true
}

Callback-уведомления

Укажите Callback URL в настройках аккаунта. Каждый раз, когда приходит код или сообщение аренды, мы отправляем его на этот URL запросом HTTP POST, JSON-тело которого содержит event и data.

Ответьте статусом 2xx в течение 5 секунд, чтобы подтвердить получение.
Если ваш сервер не ответит вовремя или вернёт другой статус, мы повторим попытку через 2 секунды, затем через 4 секунды: всего 3 попытки.
Одно и то же событие может прийти несколько раз: используйте orderId, чтобы отбрасывать повторы.

События

Событие	Когда отправляется
s1_otp_received	На номер продукта Prime пришёл код.
s1_win_premium_request	Премиум-запрос продукта Prime получил номер.
s2_otp_received	На номер продукта Pinpoint пришёл код.
s3_otp_received	На номер продукта Flex пришёл код.
s4_otp_received	На номер продукта Global пришёл код.
s5_otp_received	На номер продукта Smart пришёл код.
s6_otp_received	На номер продукта Plus пришёл код.
s7_otp_received	На номер продукта Express пришёл код.
rental_otp_received	На номер продукта Аренда Pinpoint пришло сообщение.
s3_rental_otp_received	На номер продукта Аренда Flex пришло сообщение.
s4_rental_otp_received	На номер продукта Аренда Global пришло сообщение.
s6_rental_otp_received	На номер продукта Аренда Plus пришло сообщение.

Содержимое

data.orderId: Заказ, к которому относится код.
data.timestamp: Когда мы его получили (UTC).
data.number: Номер телефона, на который он пришёл.
data.service: Сервис, для которого был заказан номер.
data.message: Полный текст сообщения.
data.otp: Код, найденный в сообщении.

Пример callback-запроса

{
  "event": "s2_otp_received",
  "data": {
    "orderId": "lr_01K7ABC",
    "timestamp": "2026-10-09 12:44:00",
    "number": "12125550102",
    "service": "google",
    "message": "G-482910 is your Google verification code.",
    "otp": "482910"
  }
}

Не получается с интеграцией? Свяжитесь с нашей командой.