API проверки оператора и переноса номера — документация

Проверка номера

Метод GET, API-ключ не требуется.

Публичный API ограничен одним запросом в секунду с IP-адреса, включая обращения с ключом. При превышении возвращается 429. Ключ сам по себе не предоставляет доступ к диагностике.

https://teldef.ru/api/?phone=79150903314

Номер можно передавать с пробелами, скобками и знаком «+». По умолчанию ответ возвращается в JSON. Для XML добавьте &format=xml.

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

{
  "phone": "79150903314",
  "ported": true,
  "ported_operator": "ПАО 'Вымпел-Коммуникации'",
  "ported_inn": "7713076301",
  "porter_date": "2026-01-22T05:03:44",
  "porter_date_source": "provider_change_observed_at",
  "porter_history": [
    {
      "operator": "ПАО 'Вымпел-Коммуникации'",
      "inn": "7713076301",
      "previous_operator": "ПАО 'Мобильные ТелеСистемы'",
      "previous_inn": "7740000076",
      "changed_at": "2026-01-22T05:03:44"
    }
  ],
  "range_found": true,
  "range": {
    "abc_def": "915",
    "operator": "ПАО \"Мобильные ТелеСистемы\"",
    "region": "г. Москва и Московская область",
    "territory": "Город Москва, Московская область"
  }
}

Основные поля

ported — найден ли номер в актуальной базе MNP.
ported_operator — оператор, обслуживающий перенесённый номер сейчас.
porter_date — дата, когда смена была зафиксирована нашей базой.
porter_history — сохранённая история повторных смен оператора.
event_kind в истории: operator_change — наблюдаемая смена; snapshot_absence — исчезновение из снимка, причина неизвестна; snapshot_reappearance — повторное появление без известного предыдущего оператора.
История: history_limit от 1 до 100; для следующей страницы передайте history_before из history_next_before. В XML события находятся в porter_history/event.
range — исходный оператор, регион и территория номерного диапазона.
generation_time_sec — время формирования API-ответа.

Статистика переносов

Ежесуточная статистика исходящих и входящих операторов, максимум за 30 дней.

https://teldef.ru/api/statistics/?days=30

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

Диапазоны оператора

/api/operator/?name=...&limit=500&offset=0. Максимум 1000 диапазонов за запрос. Следующая страница указана в next_offset; null означает конец списка.

Ошибки

400 — номер отсутствует или имеет неверный формат.
422 — параметр запроса не прошёл проверку.
403 — ключ недействителен или недостаточно прав.
429 — превышено ограничение частоты запросов.
503 — база временно недоступна или истёк срок ожидания.
500 — внутренняя ошибка сервера.