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

Авторизация

Коммерческие эндпоинты принимают API-ключ в заголовке X-API-Key. Демо-эндпоинт /v1/demo работает без ключа, но ограничен по частоте запросов.

X-API-Key: n7_...

GET /v1/lookup

Возвращает полную карточку номера. Параметр phone можно передавать в форматах +79261234567, 89261234567, 9261234567.

curl -H "X-API-Key: n7_..." \
  "https://num7.ru/v1/lookup?phone=+79261234567"

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

GET /v1/operator

Короткий ответ только с идентификатором оператора. Подходит для SMS-маршрутизации, биллинга и внутренних правил.

curl -H "X-API-Key: n7_..." \
  "https://num7.ru/v1/operator?phone=+79261234567"

{"operator": "megafon"}

Batch POST

POST /v1/lookup возвращает карточки номеров, POST /v1/operator возвращает только операторов. В одном запросе можно передать до 300 номеров.

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

Также поддерживается тело в виде массива строк:

["+79261234567", "89031234567"]

Ошибки

Полезные страницы