REST API

API определения оператора по номеру телефона

num7 возвращает текущего оператора, регион выдачи, признак переноса номера, MCC/MNC и унифицированный slug оператора для российских мобильных номеров.

Для каких задач подходит

SMS-агрегаторы

Выбор маршрута и оператора для тарификации с учётом перенесённых номеров.

CRM и CDP

Обогащение клиентских данных техническими признаками номера без данных о владельце.

Антифрод

Проверка региона, оператора и факта MNP как одного из сигналов риска.

Биллинг

Нормализация оператора в единый slug для внутренних правил и отчётности.

Что возвращает API

{
  "phone": "+79261234567",
  "operator": "МегаФон",
  "operator_slug": "megafon",
  "operator_inn": "7812014560",
  "region": "Москва и Московская область",
  "mnp_ported": false,
  "mcc": 250,
  "mnc": 2,
  "found": true
}

Поле operator_slug удобно использовать в коде: mts, megafon, beeline, t2, yota и другие значения. Для редких операторов slug может отсутствовать, но текстовое название остаётся в поле operator.

Batch до 300 номеров

Для пакетной проверки доступен POST /v1/lookup. Невалидные номера не останавливают весь запрос: по каждому элементу возвращается либо карточка номера, либо объект с ошибкой.

curl -X POST "https://num7.ru/v1/lookup" \
  -H "X-API-Key: n7_..." \
  -H "Content-Type: application/json" \
  -d '{"phones":["+79261234567","89031234567"]}'

Тарифы и подключение

Демо-режим работает без регистрации. Для коммерческого API подключение идёт через публичную оферту и оплату по счёту. На момент публикации доступны тарифы от 0,03 ₽ и 0,01 ₽ за запрос, а для больших объёмов — индивидуальные условия.