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

API Sim7

Один эндпоинт на покупку, один — на статус, один — на входящее SMS. Все запросы идут на https://sim7.org/api/v1 и авторизуются Bearer-токеном.

Базовый адрес

base_url

https://sim7.org/api/v1

Только HTTPS, тело запросов и ответов — JSON в UTF-8.

Заголовок авторизации

Bearer

Authorization

Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Ключ доступен в разделе API-ключи личного кабинета. Боевые ключи имеют формат s7_live и работают с реальным балансом.

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

Базовый URL, JSON-конверты и первый безопасный запрос.

Отправляйте HTTPS-запросы на https://sim7.org/api/v1. Успешный ответ имеет вид {"data": ...}, ошибка — {"error":{"code":"...","message":"..."}}.

Суммы — доллары США с точностью до четырёх знаков. Время — UTC в ISO 8601. Неизвестные поля в изменяющих запросах отклоняются.

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

Хешированные боевые ключи с минимальными правами.

Передавайте Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx. Создавайте ключи в кабинете. Полное значение показывается один раз; Sim7 хранит только SHA-256-хеш.

Все ключи боевые: покупки обращаются к поставщику номеров и списывают реальный баланс аккаунта. Используйте отдельный ключ только с необходимыми интеграции правами и IP-адресами.

Доступные права: catalog:read, account:read, orders:read, orders:write и webhooks:write. Для каждого ключа можно задать список IPv4, IPv6 и CIDR.

Каталог и цены

Сервисы, страны, итоговая цена, остаток и успех за 24 часа.

Списки сервисов и стран читаются из локального снимка каталога. Цена уже включает наценку Sim7 и не раскрывает поставщика.

Обновляйте цену и остаток перед покупкой и задавайте max_price для защиты от изменения цены.

GET/services

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

Каталог с минимальной итоговой ценой и общим остатком.

Параметры

Параметр	Где	Тип	Пример:
categoryОпциональный	Query	string	Точный ID категории.Пример: `messengers`
searchОпциональный	Query	string	Поиск по ID или названию без учёта регистра.Пример: `tele`

categoryQueryОпциональный
Точный ID категории.
string · Пример: messengers
searchQueryОпциональный
Поиск по ID или названию без учёта регистра.
string · Пример: tele

curl

curl -s "https://sim7.org/api/v1/services?search=tele" \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"items":[{"id":"telegram","name":"Telegram","category":"messengers","price_from":0.12,"available":48210}],"total":1}}

GET/countries

Список стран

Слаги стран, названия на двух языках, коды и общий остаток.

curl

curl -s https://sim7.org/api/v1/countries \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"items":[{"id":"germany","name_en":"Germany","name_ru":"Германия","iso":"DE","dial":"+49","available":27600}],"total":1}}

GET/prices

Цены и доступность

Итоговая цена, остаток и процент успеха за 24 часа по маршрутам.

Параметры

Параметр	Где	Тип	Пример:
serviceОбязательный	Query	string	ID сервиса.Пример: `telegram`
countryОпциональный	Query	string	Необязательный слаг страны.Пример: `germany`

serviceQueryОбязательный
ID сервиса.
string · Пример: telegram
countryQueryОпциональный
Необязательный слаг страны.
string · Пример: germany

curl

curl -s "https://sim7.org/api/v1/prices?service=telegram&country=germany" \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"service":"telegram","items":[{"country":"germany","operator":"virtual51","price":0.12,"available":18240,"success_rate_24h_percent":97.8}]}}

Заказы

Идемпотентная покупка и управление по непрозрачным ID Sim7.

Каждый изменяющий запрос публичного API требует уникальный Idempotency-Key (8–128 безопасных символов). Точный повтор возвращает сохранённый ответ, а другой запрос с тем же ключом — idempotency_conflict.

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

Ошибки до выдачи номера — insufficient_funds, no_numbers_available, price_changed, лимит частоты или активных заказов — освобождают резерв. После устранения причины повторите тот же запрос с тем же Idempotency-Key.

Если результат покупки неопределён, ключ остаётся заблокирован, чтобы не допустить повторного списания. Сохраните Idempotency-Key и передайте его поддержке; не запускайте покупку с новым ключом вслепую.

После idempotency_in_progress для действия с заказом прочитайте заказ и сверьте его состояние. Для изменения вебхука прочитайте /webhook и перевыпустите секрет подписи, если одноразовое значение потеряно. Покупка отличается: не заменяйте её ключ, пока результат не определён.

Статусы: waiting, code_received, completed, cancelled, banned и expired. Завершение доступно после кода; отмена или бан — во время ожидания с учётом задержки маршрута.

Чтение статуса использует 20-секундную аренду опроса поставщика. Параллельные запросы возвращают последний локальный снимок; обращения к поставщику дополнительно ограничены 60 в минуту на аккаунт.

POST/numbers

Купить номер

Создаёт боевую покупку со списанием баланса аккаунта.

Параметры

Параметр	Где	Тип	Пример:
Idempotency-KeyОбязательный	Заголовок	string	Уникальный ключ логической операции.Пример: `018f4af6-7d33-7c12-89b4-65c77bc36f2a`
serviceОбязательный	Тело	string	ID сервиса.Пример: `telegram`
countryОбязательный	Тело	string	Слаг страны.Пример: `germany`
operatorОпциональный	Тело	string	Точный оператор; пропустите или задайте any для выбора лучшего доступного маршрута.Пример: `any`
max_priceОпциональный	Тело	number	Максимальная итоговая цена в USD.Пример: `0.2`

Idempotency-KeyЗаголовокОбязательный
Уникальный ключ логической операции.
string · Пример: 018f4af6-7d33-7c12-89b4-65c77bc36f2a
serviceТелоОбязательный
ID сервиса.
string · Пример: telegram
countryТелоОбязательный
Слаг страны.
string · Пример: germany
operatorТелоОпциональный
Точный оператор; пропустите или задайте any для выбора лучшего доступного маршрута.
string · Пример: any
max_priceТелоОпциональный
Максимальная итоговая цена в USD.
number · Пример: 0.2

curl

curl -s -X POST https://sim7.org/api/v1/numbers \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: 018f4af6-7d33-7c12-89b4-65c77bc36f2a" \
  -H "Content-Type: application/json" \
  -d '{"service":"telegram","country":"germany","max_price":0.2}'

request.json

{"service":"telegram","country":"germany","operator":"any","max_price":0.2}

response.json

{
  "data": {
    "order_id": "ord_xxxxxxxxxxxxxxxxxxxxxx",
    "number": "+12025550142 901 234 56 78",
    "service": "telegram",
    "country": "germany",
    "operator": "virtual51",
    "price": 0.1200,
    "status": "waiting",
    "code": null,
    "messages": [],
    "expires_at": "2026-09-03T18:32:00.000Z",
    "created_at": "2026-09-03T18:12:00.000Z",
    "environment": "live"
  }
}

GET/orders/{order_id}

Статус и сообщения заказа

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

Параметры

Параметр	Где	Тип	Пример:
order_idОбязательный	Путь	string	Непрозрачный ID заказа Sim7.Пример: `ord_xxxxxxxxxxxxxxxxxxxxxx`

order_idПутьОбязательный
Непрозрачный ID заказа Sim7.
string · Пример: ord_xxxxxxxxxxxxxxxxxxxxxx

curl

curl -s https://sim7.org/api/v1/orders/ord_xxxxxxxxxxxxxxxxxxxxxx \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{
  "data": {
    "order_id": "ord_xxxxxxxxxxxxxxxxxxxxxx",
    "number": "+12025550142 901 234 56 78",
    "service": "telegram",
    "country": "germany",
    "operator": "virtual51",
    "price": 0.1200,
    "status": "waiting",
    "code": null,
    "messages": [],
    "expires_at": "2026-09-03T18:32:00.000Z",
    "created_at": "2026-09-03T18:12:00.000Z",
    "environment": "live"
  }
}

GET/orders

История заказов

История созданных через API заказов аккаунта с курсором.

Параметры

Параметр	Где	Тип	Пример:
statusОпциональный	Query	string	Один из документированных статусов.Пример: `completed`
limitОпциональный	Query	number	1–100, по умолчанию 20.Пример: `20`
cursorОпциональный	Query	string	next_cursor из предыдущего ответа.Пример: `ord_xxxxxxxxxxxxxxxxxxxxxx`

statusQueryОпциональный
Один из документированных статусов.
string · Пример: completed
limitQueryОпциональный
1–100, по умолчанию 20.
number · Пример: 20
cursorQueryОпциональный
next_cursor из предыдущего ответа.
string · Пример: ord_xxxxxxxxxxxxxxxxxxxxxx

curl

curl -s "https://sim7.org/api/v1/orders?status=completed&limit=20" \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"items":[{
    "order_id": "ord_xxxxxxxxxxxxxxxxxxxxxx",
    "number": "+12025550142 901 234 56 78",
    "service": "telegram",
    "country": "germany",
    "operator": "virtual51",
    "price": 0.1200,
    "status": "waiting",
    "code": null,
    "messages": [],
    "expires_at": "2026-09-03T18:32:00.000Z",
    "created_at": "2026-09-03T18:12:00.000Z",
    "environment": "live"
  }],"next_cursor":null}}

POST/orders/{order_id}/cancel

Отменить заказ

Закрывает ожидающий заказ; доверенный lifecycle выполняет положенный возврат ровно один раз.

Параметры

Параметр	Где	Тип	Пример:
order_idОбязательный	Путь	string	Непрозрачный ID заказа Sim7.Пример: `ord_xxxxxxxxxxxxxxxxxxxxxx`
Idempotency-KeyОбязательный	Заголовок	string	Уникальный ключ логической операции.Пример: `018f4af6-7d33-7c12-89b4-65c77bc36f2a`

order_idПутьОбязательный
Непрозрачный ID заказа Sim7.
string · Пример: ord_xxxxxxxxxxxxxxxxxxxxxx
Idempotency-KeyЗаголовокОбязательный
Уникальный ключ логической операции.
string · Пример: 018f4af6-7d33-7c12-89b4-65c77bc36f2a

curl

curl -s -X POST https://sim7.org/api/v1/orders/ord_xxxxxxxxxxxxxxxxxxxxxx/cancel \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: 018f4af6-7d33-7c12-89b4-65c77bc36f2a"

response.json

{
  "data": {
    "order_id": "ord_xxxxxxxxxxxxxxxxxxxxxx",
    "number": "+12025550142 901 234 56 78",
    "service": "telegram",
    "country": "germany",
    "operator": "virtual51",
    "price": 0.1200,
    "status": "waiting",
    "code": null,
    "messages": [],
    "expires_at": "2026-09-03T18:32:00.000Z",
    "created_at": "2026-09-03T18:12:00.000Z",
    "environment": "live"
  }
}

POST/orders/{order_id}/finish

Завершить заказ

Подтверждает заказ после получения кода.

Параметры

Параметр	Где	Тип	Пример:
order_idОбязательный	Путь	string	Непрозрачный ID заказа Sim7.Пример: `ord_xxxxxxxxxxxxxxxxxxxxxx`
Idempotency-KeyОбязательный	Заголовок	string	Уникальный ключ логической операции.Пример: `018f4af6-7d33-7c12-89b4-65c77bc36f2a`

order_idПутьОбязательный
Непрозрачный ID заказа Sim7.
string · Пример: ord_xxxxxxxxxxxxxxxxxxxxxx
Idempotency-KeyЗаголовокОбязательный
Уникальный ключ логической операции.
string · Пример: 018f4af6-7d33-7c12-89b4-65c77bc36f2a

curl

curl -s -X POST https://sim7.org/api/v1/orders/ord_xxxxxxxxxxxxxxxxxxxxxx/finish \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: 018f4af6-7d33-7c12-89b4-65c77bc36f2a"

response.json

{
  "data": {
    "order_id": "ord_xxxxxxxxxxxxxxxxxxxxxx",
    "number": "+12025550142 901 234 56 78",
    "service": "telegram",
    "country": "germany",
    "operator": "virtual51",
    "price": 0.1200,
    "status": "waiting",
    "code": null,
    "messages": [],
    "expires_at": "2026-09-03T18:32:00.000Z",
    "created_at": "2026-09-03T18:12:00.000Z",
    "environment": "live"
  }
}

POST/orders/{order_id}/ban

Забанить номер

Закрывает ожидающий заказ; доверенный lifecycle выполняет положенный возврат ровно один раз.

Параметры

Параметр	Где	Тип	Пример:
order_idОбязательный	Путь	string	Непрозрачный ID заказа Sim7.Пример: `ord_xxxxxxxxxxxxxxxxxxxxxx`
Idempotency-KeyОбязательный	Заголовок	string	Уникальный ключ логической операции.Пример: `018f4af6-7d33-7c12-89b4-65c77bc36f2a`

order_idПутьОбязательный
Непрозрачный ID заказа Sim7.
string · Пример: ord_xxxxxxxxxxxxxxxxxxxxxx
Idempotency-KeyЗаголовокОбязательный
Уникальный ключ логической операции.
string · Пример: 018f4af6-7d33-7c12-89b4-65c77bc36f2a

curl

curl -s -X POST https://sim7.org/api/v1/orders/ord_xxxxxxxxxxxxxxxxxxxxxx/ban \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: 018f4af6-7d33-7c12-89b4-65c77bc36f2a"

response.json

{
  "data": {
    "order_id": "ord_xxxxxxxxxxxxxxxxxxxxxx",
    "number": "+12025550142 901 234 56 78",
    "service": "telegram",
    "country": "germany",
    "operator": "virtual51",
    "price": 0.1200,
    "status": "waiting",
    "code": null,
    "messages": [],
    "expires_at": "2026-09-03T18:32:00.000Z",
    "created_at": "2026-09-03T18:12:00.000Z",
    "environment": "live"
  }
}

Аккаунт

Баланс и фиксированные лимиты аккаунта.

Эндпоинт аккаунта возвращает идентификатор, активные API-заказы, реальный USD-баланс и фиксированный общий лимит 600 запросов в минуту. Несколько ключей делят этот лимит и не могут его увеличить.

GET/account

Аккаунт и лимиты

Аккаунт, боевой баланс и действующие лимиты.

curl

curl -s https://sim7.org/api/v1/account \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"account_id":"user_id","email":"user@example.com","environment":"live","balance":42.5,"currency":"USD","charges_real_balance":true,"limits":{"concurrent_orders":250,"active_orders":3,"requests_per_minute":600}}}

GET/balance

Баланс

Компактный ответ с реальным балансом аккаунта.

curl

curl -s https://sim7.org/api/v1/balance \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"balance":42.5,"currency":"USD","environment":"live","charges_real_balance":true}}

Вебхуки

Подписанные HMAC исходящие события с повторами.

Настройте HTTPS-адрес и события через PUT /webhook или в «Кабинет → API-ключи». Секрет меняется в кабинете и показывается только при создании или ротации.

Разберите X-Sim7-Signature в формате v1=<hex в нижнем регистре> и проверьте hex как HMAC-SHA256(secret, timestamp + "." + rawBody), где timestamp — точное значение X-Sim7-Timestamp. Заголовок X-Sim7-Secret-Version указывает версию сохранённого секрета. Сравнивайте за постоянное время и отклоняйте старые метки.

Доставка выполняется минимум один раз. Sim7 принимает любой ответ 2xx за пять секунд и делает всего пять попыток: первую отправку и четыре повтора через 10 с, 30 с, 2 мин и 5 мин. Используйте X-Sim7-Delivery для дедупликации.

Доставка в очереди сохраняет версию секрета на момент создания. Каждая повторная попытка получает новую метку времени и подпись с той же версией секрета. После ротации храните предыдущий секрет, пока старая очередь не завершится.

События одного обработчика доставляются в порядке создания. Медленный обработчик занимает не более одного глобального воркера, а его незавершённая очередь ограничена 500 событиями. Отключение доставки отменяет очередь; события до создания обработчика и во время отключения после включения не догоняются.

Журналы доставленных и окончательно неуспешных запросов хранятся 30 дней. Ожидающие и выполняющиеся доставки очистка не удаляет.

GET/webhook

Получить настройки вебхука

Возвращает обработчик текущего ключа без секрета подписи.

curl

curl -s https://sim7.org/api/v1/webhook -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"url":"https://example.com/webhooks/sim7","events":["order.code_received"],"is_enabled":true,"secret_version":1,"updated_at":"2026-09-03T18:12:00.000Z"}}

PUT/webhook

Создать или обновить вебхук

Проверяет публичный HTTPS-адрес. secret возвращается только при создании; повтор с тем же ключом идемпотентности скрывает его.

Параметры

Параметр	Где	Тип	Пример:
Idempotency-KeyОбязательный	Заголовок	string	Уникальный ключ логической операции.Пример: `018f4af6-7d33-7c12-89b4-65c77bc36f2a`
urlОбязательный	Тело	string	Публичный HTTPS URL на порту 443.Пример: `https://example.com/webhooks/sim7`
eventsОбязательный	Тело	string[]	Массив документированных событий.Пример: `["order.code_received"]`
is_enabledОпциональный	Тело	boolean	Отключить или включить будущие доставки. Отключение отменяет очередь; пропущенные события не догоняются.Пример: `true`

Idempotency-KeyЗаголовокОбязательный
Уникальный ключ логической операции.
string · Пример: 018f4af6-7d33-7c12-89b4-65c77bc36f2a
urlТелоОбязательный
Публичный HTTPS URL на порту 443.
string · Пример: https://example.com/webhooks/sim7
eventsТелоОбязательный
Массив документированных событий.
string[] · Пример: ["order.code_received"]
is_enabledТелоОпциональный
Отключить или включить будущие доставки. Отключение отменяет очередь; пропущенные события не догоняются.
boolean · Пример: true

curl

curl -s -X PUT https://sim7.org/api/v1/webhook -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -H "Idempotency-Key: 018f4af6-7d33-7c12-89b4-65c77bc36f2a" -H "Content-Type: application/json" -d '{"url":"https://example.com/webhooks/sim7","events":["order.code_received"],"is_enabled":true}'

request.json

{"url":"https://example.com/webhooks/sim7","events":["order.code_received"],"is_enabled":true}

response.json

{"data":{"url":"https://example.com/webhooks/sim7","events":["order.code_received"],"is_enabled":true,"secret_version":1,"updated_at":"2026-09-03T18:12:00.000Z","secret":"whsec_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"}}

DELETE/webhook

Удалить вебхук

Останавливает доставку и удаляет очередь и журналы этого обработчика.

Параметры

Параметр	Где	Тип	Пример:
Idempotency-KeyОбязательный	Заголовок	string	Уникальный ключ логической операции.Пример: `018f4af6-7d33-7c12-89b4-65c77bc36f2a`

Idempotency-KeyЗаголовокОбязательный
Уникальный ключ логической операции.
string · Пример: 018f4af6-7d33-7c12-89b4-65c77bc36f2a

curl

curl -s -X DELETE https://sim7.org/api/v1/webhook -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -H "Idempotency-Key: 018f4af6-7d33-7c12-89b4-65c77bc36f2a"

response.json

{"data":{"deleted":true}}

GET/webhook/deliveries

Журнал доставок

Возвращает последние 50 доставок без тел запросов и секретов.

curl

curl -s https://sim7.org/api/v1/webhook/deliveries -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"items":[{"id":"delivery_id","event":"order.code_received","status":"delivered","attempts":1,"response_status":204,"secret_version":1}]}}

POSThttps://example.com/webhooks/sim7

Тело исходящего события

Пример запроса от Sim7; это ваш обработчик, а не эндпоинт API Sim7.

curl

# Signature input: <X-Sim7-Timestamp>.<raw JSON body>
# Headers: X-Sim7-Delivery, X-Sim7-Event, X-Sim7-Timestamp, X-Sim7-Signature, X-Sim7-Secret-Version

request.json

{"id":"delivery_id","event":"order.code_received","created_at":"2026-09-03T18:12:44.000Z","data":{"order_id":"ord_xxxxxxxxxxxxxxxxxxxxxx","number":"+12025550142 901 234 56 78","code":"482913","status":"code_received"}}

response.json

HTTP/1.1 204 No Content

Ошибки и лимиты

Стабильные машинные коды и настраиваемые лимиты ключа.

Ориентируйтесь на error.code. Повторяйте 429 и временные 5xx с задержкой. Не повторяйте неизменённый 4xx и не заменяйте ключ идемпотентности неопределённой покупки.

Коды ошибок

Коды ошибок API Sim7
Код	HTTP	Что произошло
`invalid_request`	400	Некорректный запросНеверный параметр, JSON, Content-Type или размер тела.
`invalid_idempotency_key`	400	Неверный ключ идемпотентностиВ изменяющем запросе отсутствует корректный Idempotency-Key.
`unauthorized`	401	Ключ не принятBearer-ключ отсутствует, повреждён, истёк, отозван или неверен.
`insufficient_funds`	402	Недостаточно средствБоевого баланса не хватает на выбранный маршрут.
`ip_not_allowed`	403	IP не разрешёнIP запроса отсутствует в списке ключа.
`scope_forbidden`	403	Недостаточно правУ ключа нет права для этого эндпоинта.
`order_not_found`	404	Заказ не найденID неизвестен или принадлежит другому аккаунту.
`no_numbers_available`	409	Нет номеровНет маршрута с остатком под запрос.
`price_changed`	409	Цена измениласьИтоговая цена превышает max_price.
`order_not_actionable`	409	Действие недоступноТекущее состояние не допускает действие.
`idempotency_conflict`	409	Конфликт идемпотентностиКлюч уже использован с другими входными данными.
`idempotency_in_progress`	409	Результат уточняетсяИсходная операция выполняется или требует сверки поддержкой.
`rate_limited`	429	Лимит запросовПревышен лимит ключа или защитный лимит.
`concurrency_limit`	429	Слишком много активных заказовЗакройте активный заказ перед новой покупкой.
`internal_error`	500	Внутренняя ошибкаБезопасная общая ошибка без данных поставщика.
`service_unavailable`	503	НедоступноНеобходимая зависимость временно недоступна.
`purchase_reconciliation_required`	503	Нужна сверка покупкиНомер мог быть выдан, но компенсационная отмена не подтверждена. Сохраните исходный Idempotency-Key и обратитесь в поддержку; не создавайте замену вслепую.

invalid_request400
Некорректный запрос
Неверный параметр, JSON, Content-Type или размер тела.
invalid_idempotency_key400
Неверный ключ идемпотентности
В изменяющем запросе отсутствует корректный Idempotency-Key.
unauthorized401
Ключ не принят
Bearer-ключ отсутствует, повреждён, истёк, отозван или неверен.
insufficient_funds402
Недостаточно средств
Боевого баланса не хватает на выбранный маршрут.
ip_not_allowed403
IP не разрешён
IP запроса отсутствует в списке ключа.
scope_forbidden403
Недостаточно прав
У ключа нет права для этого эндпоинта.
order_not_found404
Заказ не найден
ID неизвестен или принадлежит другому аккаунту.
no_numbers_available409
Нет номеров
Нет маршрута с остатком под запрос.
price_changed409
Цена изменилась
Итоговая цена превышает max_price.
order_not_actionable409
Действие недоступно
Текущее состояние не допускает действие.
idempotency_conflict409
Конфликт идемпотентности
Ключ уже использован с другими входными данными.
idempotency_in_progress409
Результат уточняется
Исходная операция выполняется или требует сверки поддержкой.
rate_limited429
Лимит запросов
Превышен лимит ключа или защитный лимит.
concurrency_limit429
Слишком много активных заказов
Закройте активный заказ перед новой покупкой.
internal_error500
Внутренняя ошибка
Безопасная общая ошибка без данных поставщика.
service_unavailable503
Недоступно
Необходимая зависимость временно недоступна.
purchase_reconciliation_required503
Нужна сверка покупки
Номер мог быть выдан, но компенсационная отмена не подтверждена. Сохраните исходный Idempotency-Key и обратитесь в поддержку; не создавайте замену вслепую.

Частота запросов

Лимиты частоты запросов по тарифам
Тариф	Запросов в минуту	Примечание
Все API-запросы	600	Фиксировано для всего аккаунта и каждого ключа. Новые ключи не увеличивают общий лимит.
Создание заказов	20	Отдельно применяется к аккаунту, ключу и доверенному IP; общий лимит 600 запросов также действует.
Боевые проверки статуса	60 на аккаунт	20-секундная аренда на заказ перекрывает таймауты поставщика и объединяет параллельные GET-запросы в одну проверку.

Все API-запросы600
Фиксировано для всего аккаунта и каждого ключа. Новые ключи не увеличивают общий лимит.
Создание заказов20
Отдельно применяется к аккаунту, ключу и доверенному IP; общий лимит 600 запросов также действует.
Боевые проверки статуса60 на аккаунт
20-секундная аренда на заказ перекрывает таймауты поставщика и объединяет параллельные GET-запросы в одну проверку.

Текущее состояние компонентов и историю инцидентов мы публикуем на странице статуса.

Готовы попробовать?

Создайте боевой ключ в личном кабинете. Лимит 600 запросов в минуту фиксирован для всего аккаунта, а подпись вебхуков проверяется по заголовку X-Sim7-Signature.

Получить ключ доступа Мои API-ключи

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

API Sim7

Базовый адрес

base_url

https://sim7.org/api/v1

Только HTTPS, тело запросов и ответов — JSON в UTF-8.

Заголовок авторизации

Bearer

Authorization

Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

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

Базовый URL, JSON-конверты и первый безопасный запрос.

Отправляйте HTTPS-запросы на https://sim7.org/api/v1. Успешный ответ имеет вид {"data": ...}, ошибка — {"error":{"code":"...","message":"..."}}.

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

Хешированные боевые ключи с минимальными правами.

Доступные права: catalog:read, account:read, orders:read, orders:write и webhooks:write. Для каждого ключа можно задать список IPv4, IPv6 и CIDR.

Каталог и цены

Сервисы, страны, итоговая цена, остаток и успех за 24 часа.

Обновляйте цену и остаток перед покупкой и задавайте max_price для защиты от изменения цены.

GET/services

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

Каталог с минимальной итоговой ценой и общим остатком.

Параметры

Параметр	Где	Тип	Пример:
categoryОпциональный	Query	string	Точный ID категории.Пример: `messengers`
searchОпциональный	Query	string	Поиск по ID или названию без учёта регистра.Пример: `tele`

categoryQueryОпциональный
Точный ID категории.
string · Пример: messengers
searchQueryОпциональный
Поиск по ID или названию без учёта регистра.
string · Пример: tele

curl

curl -s "https://sim7.org/api/v1/services?search=tele" \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"items":[{"id":"telegram","name":"Telegram","category":"messengers","price_from":0.12,"available":48210}],"total":1}}

GET/countries

Список стран

Слаги стран, названия на двух языках, коды и общий остаток.

curl

curl -s https://sim7.org/api/v1/countries \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"items":[{"id":"germany","name_en":"Germany","name_ru":"Германия","iso":"DE","dial":"+49","available":27600}],"total":1}}

GET/prices

Цены и доступность

Итоговая цена, остаток и процент успеха за 24 часа по маршрутам.

Параметры

Параметр	Где	Тип	Пример:
serviceОбязательный	Query	string	ID сервиса.Пример: `telegram`
countryОпциональный	Query	string	Необязательный слаг страны.Пример: `germany`

serviceQueryОбязательный
ID сервиса.
string · Пример: telegram
countryQueryОпциональный
Необязательный слаг страны.
string · Пример: germany

curl

curl -s "https://sim7.org/api/v1/prices?service=telegram&country=germany" \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"service":"telegram","items":[{"country":"germany","operator":"virtual51","price":0.12,"available":18240,"success_rate_24h_percent":97.8}]}}

Заказы

Идемпотентная покупка и управление по непрозрачным ID Sim7.

POST/numbers

Купить номер

Создаёт боевую покупку со списанием баланса аккаунта.

Параметры

Параметр	Где	Тип	Пример:
Idempotency-KeyОбязательный	Заголовок	string	Уникальный ключ логической операции.Пример: `018f4af6-7d33-7c12-89b4-65c77bc36f2a`
serviceОбязательный	Тело	string	ID сервиса.Пример: `telegram`
countryОбязательный	Тело	string	Слаг страны.Пример: `germany`
operatorОпциональный	Тело	string	Точный оператор; пропустите или задайте any для выбора лучшего доступного маршрута.Пример: `any`
max_priceОпциональный	Тело	number	Максимальная итоговая цена в USD.Пример: `0.2`

Idempotency-KeyЗаголовокОбязательный
Уникальный ключ логической операции.
string · Пример: 018f4af6-7d33-7c12-89b4-65c77bc36f2a
serviceТелоОбязательный
ID сервиса.
string · Пример: telegram
countryТелоОбязательный
Слаг страны.
string · Пример: germany
operatorТелоОпциональный
Точный оператор; пропустите или задайте any для выбора лучшего доступного маршрута.
string · Пример: any
max_priceТелоОпциональный
Максимальная итоговая цена в USD.
number · Пример: 0.2

curl

curl -s -X POST https://sim7.org/api/v1/numbers \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: 018f4af6-7d33-7c12-89b4-65c77bc36f2a" \
  -H "Content-Type: application/json" \
  -d '{"service":"telegram","country":"germany","max_price":0.2}'

request.json

{"service":"telegram","country":"germany","operator":"any","max_price":0.2}

response.json

{
  "data": {
    "order_id": "ord_xxxxxxxxxxxxxxxxxxxxxx",
    "number": "+12025550142 901 234 56 78",
    "service": "telegram",
    "country": "germany",
    "operator": "virtual51",
    "price": 0.1200,
    "status": "waiting",
    "code": null,
    "messages": [],
    "expires_at": "2026-09-03T18:32:00.000Z",
    "created_at": "2026-09-03T18:12:00.000Z",
    "environment": "live"
  }
}

GET/orders/{order_id}

Статус и сообщения заказа

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

Параметры

Параметр	Где	Тип	Пример:
order_idОбязательный	Путь	string	Непрозрачный ID заказа Sim7.Пример: `ord_xxxxxxxxxxxxxxxxxxxxxx`

order_idПутьОбязательный
Непрозрачный ID заказа Sim7.
string · Пример: ord_xxxxxxxxxxxxxxxxxxxxxx

curl

curl -s https://sim7.org/api/v1/orders/ord_xxxxxxxxxxxxxxxxxxxxxx \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{
  "data": {
    "order_id": "ord_xxxxxxxxxxxxxxxxxxxxxx",
    "number": "+12025550142 901 234 56 78",
    "service": "telegram",
    "country": "germany",
    "operator": "virtual51",
    "price": 0.1200,
    "status": "waiting",
    "code": null,
    "messages": [],
    "expires_at": "2026-09-03T18:32:00.000Z",
    "created_at": "2026-09-03T18:12:00.000Z",
    "environment": "live"
  }
}

GET/orders

История заказов

История созданных через API заказов аккаунта с курсором.

Параметры

Параметр	Где	Тип	Пример:
statusОпциональный	Query	string	Один из документированных статусов.Пример: `completed`
limitОпциональный	Query	number	1–100, по умолчанию 20.Пример: `20`
cursorОпциональный	Query	string	next_cursor из предыдущего ответа.Пример: `ord_xxxxxxxxxxxxxxxxxxxxxx`

statusQueryОпциональный
Один из документированных статусов.
string · Пример: completed
limitQueryОпциональный
1–100, по умолчанию 20.
number · Пример: 20
cursorQueryОпциональный
next_cursor из предыдущего ответа.
string · Пример: ord_xxxxxxxxxxxxxxxxxxxxxx

curl

curl -s "https://sim7.org/api/v1/orders?status=completed&limit=20" \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"items":[{
    "order_id": "ord_xxxxxxxxxxxxxxxxxxxxxx",
    "number": "+12025550142 901 234 56 78",
    "service": "telegram",
    "country": "germany",
    "operator": "virtual51",
    "price": 0.1200,
    "status": "waiting",
    "code": null,
    "messages": [],
    "expires_at": "2026-09-03T18:32:00.000Z",
    "created_at": "2026-09-03T18:12:00.000Z",
    "environment": "live"
  }],"next_cursor":null}}

POST/orders/{order_id}/cancel

Отменить заказ

Закрывает ожидающий заказ; доверенный lifecycle выполняет положенный возврат ровно один раз.

Параметры

Параметр	Где	Тип	Пример:
order_idОбязательный	Путь	string	Непрозрачный ID заказа Sim7.Пример: `ord_xxxxxxxxxxxxxxxxxxxxxx`
Idempotency-KeyОбязательный	Заголовок	string	Уникальный ключ логической операции.Пример: `018f4af6-7d33-7c12-89b4-65c77bc36f2a`

order_idПутьОбязательный
Непрозрачный ID заказа Sim7.
string · Пример: ord_xxxxxxxxxxxxxxxxxxxxxx
Idempotency-KeyЗаголовокОбязательный
Уникальный ключ логической операции.
string · Пример: 018f4af6-7d33-7c12-89b4-65c77bc36f2a

curl

curl -s -X POST https://sim7.org/api/v1/orders/ord_xxxxxxxxxxxxxxxxxxxxxx/cancel \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: 018f4af6-7d33-7c12-89b4-65c77bc36f2a"

response.json

{
  "data": {
    "order_id": "ord_xxxxxxxxxxxxxxxxxxxxxx",
    "number": "+12025550142 901 234 56 78",
    "service": "telegram",
    "country": "germany",
    "operator": "virtual51",
    "price": 0.1200,
    "status": "waiting",
    "code": null,
    "messages": [],
    "expires_at": "2026-09-03T18:32:00.000Z",
    "created_at": "2026-09-03T18:12:00.000Z",
    "environment": "live"
  }
}

POST/orders/{order_id}/finish

Завершить заказ

Подтверждает заказ после получения кода.

Параметры

Параметр	Где	Тип	Пример:
order_idОбязательный	Путь	string	Непрозрачный ID заказа Sim7.Пример: `ord_xxxxxxxxxxxxxxxxxxxxxx`
Idempotency-KeyОбязательный	Заголовок	string	Уникальный ключ логической операции.Пример: `018f4af6-7d33-7c12-89b4-65c77bc36f2a`

order_idПутьОбязательный
Непрозрачный ID заказа Sim7.
string · Пример: ord_xxxxxxxxxxxxxxxxxxxxxx
Idempotency-KeyЗаголовокОбязательный
Уникальный ключ логической операции.
string · Пример: 018f4af6-7d33-7c12-89b4-65c77bc36f2a

curl

curl -s -X POST https://sim7.org/api/v1/orders/ord_xxxxxxxxxxxxxxxxxxxxxx/finish \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: 018f4af6-7d33-7c12-89b4-65c77bc36f2a"

response.json

{
  "data": {
    "order_id": "ord_xxxxxxxxxxxxxxxxxxxxxx",
    "number": "+12025550142 901 234 56 78",
    "service": "telegram",
    "country": "germany",
    "operator": "virtual51",
    "price": 0.1200,
    "status": "waiting",
    "code": null,
    "messages": [],
    "expires_at": "2026-09-03T18:32:00.000Z",
    "created_at": "2026-09-03T18:12:00.000Z",
    "environment": "live"
  }
}

POST/orders/{order_id}/ban

Забанить номер

Закрывает ожидающий заказ; доверенный lifecycle выполняет положенный возврат ровно один раз.

Параметры

Параметр	Где	Тип	Пример:
order_idОбязательный	Путь	string	Непрозрачный ID заказа Sim7.Пример: `ord_xxxxxxxxxxxxxxxxxxxxxx`
Idempotency-KeyОбязательный	Заголовок	string	Уникальный ключ логической операции.Пример: `018f4af6-7d33-7c12-89b4-65c77bc36f2a`

order_idПутьОбязательный
Непрозрачный ID заказа Sim7.
string · Пример: ord_xxxxxxxxxxxxxxxxxxxxxx
Idempotency-KeyЗаголовокОбязательный
Уникальный ключ логической операции.
string · Пример: 018f4af6-7d33-7c12-89b4-65c77bc36f2a

curl

curl -s -X POST https://sim7.org/api/v1/orders/ord_xxxxxxxxxxxxxxxxxxxxxx/ban \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: 018f4af6-7d33-7c12-89b4-65c77bc36f2a"

response.json

{
  "data": {
    "order_id": "ord_xxxxxxxxxxxxxxxxxxxxxx",
    "number": "+12025550142 901 234 56 78",
    "service": "telegram",
    "country": "germany",
    "operator": "virtual51",
    "price": 0.1200,
    "status": "waiting",
    "code": null,
    "messages": [],
    "expires_at": "2026-09-03T18:32:00.000Z",
    "created_at": "2026-09-03T18:12:00.000Z",
    "environment": "live"
  }
}

Аккаунт

Баланс и фиксированные лимиты аккаунта.

GET/account

Аккаунт и лимиты

Аккаунт, боевой баланс и действующие лимиты.

curl

curl -s https://sim7.org/api/v1/account \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"account_id":"user_id","email":"user@example.com","environment":"live","balance":42.5,"currency":"USD","charges_real_balance":true,"limits":{"concurrent_orders":250,"active_orders":3,"requests_per_minute":600}}}

GET/balance

Баланс

Компактный ответ с реальным балансом аккаунта.

curl

curl -s https://sim7.org/api/v1/balance \
  -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"balance":42.5,"currency":"USD","environment":"live","charges_real_balance":true}}

Вебхуки

Подписанные HMAC исходящие события с повторами.

GET/webhook

Получить настройки вебхука

Возвращает обработчик текущего ключа без секрета подписи.

curl

curl -s https://sim7.org/api/v1/webhook -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"url":"https://example.com/webhooks/sim7","events":["order.code_received"],"is_enabled":true,"secret_version":1,"updated_at":"2026-09-03T18:12:00.000Z"}}

PUT/webhook

Создать или обновить вебхук

Параметры

Параметр	Где	Тип	Пример:
Idempotency-KeyОбязательный	Заголовок	string	Уникальный ключ логической операции.Пример: `018f4af6-7d33-7c12-89b4-65c77bc36f2a`
urlОбязательный	Тело	string	Публичный HTTPS URL на порту 443.Пример: `https://example.com/webhooks/sim7`
eventsОбязательный	Тело	string[]	Массив документированных событий.Пример: `["order.code_received"]`
is_enabledОпциональный	Тело	boolean	Отключить или включить будущие доставки. Отключение отменяет очередь; пропущенные события не догоняются.Пример: `true`

Idempotency-KeyЗаголовокОбязательный
Уникальный ключ логической операции.
string · Пример: 018f4af6-7d33-7c12-89b4-65c77bc36f2a
urlТелоОбязательный
Публичный HTTPS URL на порту 443.
string · Пример: https://example.com/webhooks/sim7
eventsТелоОбязательный
Массив документированных событий.
string[] · Пример: ["order.code_received"]
is_enabledТелоОпциональный
Отключить или включить будущие доставки. Отключение отменяет очередь; пропущенные события не догоняются.
boolean · Пример: true

curl

curl -s -X PUT https://sim7.org/api/v1/webhook -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -H "Idempotency-Key: 018f4af6-7d33-7c12-89b4-65c77bc36f2a" -H "Content-Type: application/json" -d '{"url":"https://example.com/webhooks/sim7","events":["order.code_received"],"is_enabled":true}'

request.json

{"url":"https://example.com/webhooks/sim7","events":["order.code_received"],"is_enabled":true}

response.json

{"data":{"url":"https://example.com/webhooks/sim7","events":["order.code_received"],"is_enabled":true,"secret_version":1,"updated_at":"2026-09-03T18:12:00.000Z","secret":"whsec_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"}}

DELETE/webhook

Удалить вебхук

Останавливает доставку и удаляет очередь и журналы этого обработчика.

Параметры

Параметр	Где	Тип	Пример:
Idempotency-KeyОбязательный	Заголовок	string	Уникальный ключ логической операции.Пример: `018f4af6-7d33-7c12-89b4-65c77bc36f2a`

Idempotency-KeyЗаголовокОбязательный
Уникальный ключ логической операции.
string · Пример: 018f4af6-7d33-7c12-89b4-65c77bc36f2a

curl

curl -s -X DELETE https://sim7.org/api/v1/webhook -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -H "Idempotency-Key: 018f4af6-7d33-7c12-89b4-65c77bc36f2a"

response.json

{"data":{"deleted":true}}

GET/webhook/deliveries

Журнал доставок

Возвращает последние 50 доставок без тел запросов и секретов.

curl

curl -s https://sim7.org/api/v1/webhook/deliveries -H "Authorization: Bearer s7_live_xxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

response.json

{"data":{"items":[{"id":"delivery_id","event":"order.code_received","status":"delivered","attempts":1,"response_status":204,"secret_version":1}]}}

POSThttps://example.com/webhooks/sim7

Тело исходящего события

Пример запроса от Sim7; это ваш обработчик, а не эндпоинт API Sim7.

curl

# Signature input: <X-Sim7-Timestamp>.<raw JSON body>
# Headers: X-Sim7-Delivery, X-Sim7-Event, X-Sim7-Timestamp, X-Sim7-Signature, X-Sim7-Secret-Version

request.json

{"id":"delivery_id","event":"order.code_received","created_at":"2026-09-03T18:12:44.000Z","data":{"order_id":"ord_xxxxxxxxxxxxxxxxxxxxxx","number":"+12025550142 901 234 56 78","code":"482913","status":"code_received"}}

response.json

HTTP/1.1 204 No Content

Ошибки и лимиты

Стабильные машинные коды и настраиваемые лимиты ключа.

Коды ошибок

Коды ошибок API Sim7
Код	HTTP	Что произошло
`invalid_request`	400	Некорректный запросНеверный параметр, JSON, Content-Type или размер тела.
`invalid_idempotency_key`	400	Неверный ключ идемпотентностиВ изменяющем запросе отсутствует корректный Idempotency-Key.
`unauthorized`	401	Ключ не принятBearer-ключ отсутствует, повреждён, истёк, отозван или неверен.
`insufficient_funds`	402	Недостаточно средствБоевого баланса не хватает на выбранный маршрут.
`ip_not_allowed`	403	IP не разрешёнIP запроса отсутствует в списке ключа.
`scope_forbidden`	403	Недостаточно правУ ключа нет права для этого эндпоинта.
`order_not_found`	404	Заказ не найденID неизвестен или принадлежит другому аккаунту.
`no_numbers_available`	409	Нет номеровНет маршрута с остатком под запрос.
`price_changed`	409	Цена измениласьИтоговая цена превышает max_price.
`order_not_actionable`	409	Действие недоступноТекущее состояние не допускает действие.
`idempotency_conflict`	409	Конфликт идемпотентностиКлюч уже использован с другими входными данными.
`idempotency_in_progress`	409	Результат уточняетсяИсходная операция выполняется или требует сверки поддержкой.
`rate_limited`	429	Лимит запросовПревышен лимит ключа или защитный лимит.
`concurrency_limit`	429	Слишком много активных заказовЗакройте активный заказ перед новой покупкой.
`internal_error`	500	Внутренняя ошибкаБезопасная общая ошибка без данных поставщика.
`service_unavailable`	503	НедоступноНеобходимая зависимость временно недоступна.
`purchase_reconciliation_required`	503	Нужна сверка покупкиНомер мог быть выдан, но компенсационная отмена не подтверждена. Сохраните исходный Idempotency-Key и обратитесь в поддержку; не создавайте замену вслепую.

invalid_request400
Некорректный запрос
Неверный параметр, JSON, Content-Type или размер тела.
invalid_idempotency_key400
Неверный ключ идемпотентности
В изменяющем запросе отсутствует корректный Idempotency-Key.
unauthorized401
Ключ не принят
Bearer-ключ отсутствует, повреждён, истёк, отозван или неверен.
insufficient_funds402
Недостаточно средств
Боевого баланса не хватает на выбранный маршрут.
ip_not_allowed403
IP не разрешён
IP запроса отсутствует в списке ключа.
scope_forbidden403
Недостаточно прав
У ключа нет права для этого эндпоинта.
order_not_found404
Заказ не найден
ID неизвестен или принадлежит другому аккаунту.
no_numbers_available409
Нет номеров
Нет маршрута с остатком под запрос.
price_changed409
Цена изменилась
Итоговая цена превышает max_price.
order_not_actionable409
Действие недоступно
Текущее состояние не допускает действие.
idempotency_conflict409
Конфликт идемпотентности
Ключ уже использован с другими входными данными.
idempotency_in_progress409
Результат уточняется
Исходная операция выполняется или требует сверки поддержкой.
rate_limited429
Лимит запросов
Превышен лимит ключа или защитный лимит.
concurrency_limit429
Слишком много активных заказов
Закройте активный заказ перед новой покупкой.
internal_error500
Внутренняя ошибка
Безопасная общая ошибка без данных поставщика.
service_unavailable503
Недоступно
Необходимая зависимость временно недоступна.
purchase_reconciliation_required503
Нужна сверка покупки
Номер мог быть выдан, но компенсационная отмена не подтверждена. Сохраните исходный Idempotency-Key и обратитесь в поддержку; не создавайте замену вслепую.

Частота запросов

Лимиты частоты запросов по тарифам
Тариф	Запросов в минуту	Примечание
Все API-запросы	600	Фиксировано для всего аккаунта и каждого ключа. Новые ключи не увеличивают общий лимит.
Создание заказов	20	Отдельно применяется к аккаунту, ключу и доверенному IP; общий лимит 600 запросов также действует.
Боевые проверки статуса	60 на аккаунт	20-секундная аренда на заказ перекрывает таймауты поставщика и объединяет параллельные GET-запросы в одну проверку.

Все API-запросы600
Фиксировано для всего аккаунта и каждого ключа. Новые ключи не увеличивают общий лимит.
Создание заказов20
Отдельно применяется к аккаунту, ключу и доверенному IP; общий лимит 600 запросов также действует.
Боевые проверки статуса60 на аккаунт
20-секундная аренда на заказ перекрывает таймауты поставщика и объединяет параллельные GET-запросы в одну проверку.

Текущее состояние компонентов и историю инцидентов мы публикуем на странице статуса.

Готовы попробовать?

Получить ключ доступа Мои API-ключи