Нормализованный номер
Приведение телефона к стандартному формату и проверка структуры номера по плану нумерации. Это не проверка активности SIM-карты.
REST API для разработчиков
API определения региона, оператора и времени по номеру телефона
Обогащайте контакты в CRM и собственной системе: передайте телефон и получите справочные данные о номере в JSON. Часовой пояс поможет выбрать время для звонка.
100 запросов бесплатно в календарный месяц.
Какие данные возвращает Phone API
Страна и регион
Справочная география выделенного диапазона номера. Используйте её как дополнительное поле контакта, а не текущий адрес абонента.
Оператор диапазона
Оператор, которому выделен диапазон. Перенос номера между операторами (MNP) в текущем сервисе не проверяется.
Часовой пояс и местное время
Время по справочной географии номера помогает планировать коммуникации. Оно не подтверждает, где человек находится сейчас.
API не определяет владельца номера, активность SIM-карты или текущее местоположение человека. Регион и оператор относятся к выделенному диапазону; перенос номера к другому оператору не проверяется.
Попробуйте Phone API онлайн
Реальный ответ сервиса без API-ключа. Для интеграции создайте свой ключ в кабинете.
Ответ APIJSON
Ответ появится здесь
Обогащение контактов в CRM через API
Добавьте регион, оператора диапазона и справочное время в карточку контакта. Один HTTP-запрос можно встроить в обработку входящей заявки, импорт базы или серверную автоматизацию.
- Получите телефон из заявки или карточки CRM.
- Вызовите POST /def/v1/lookup с ключом, у которого есть scope phone.
- Сохраните нужные поля JSON и используйте часовой пояс в логике звонков.
Пример запроса к Phone API
curl -X POST 'https://api.ibop.ru/def/v1/lookup' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"phone":"+79991234567"}'Получите ключ после входа через MAX и передавайте его в Authorization: Bearer YOUR_API_KEY. Область доступа ключа должна включать phone. Храните секрет на сервере своей интеграции.
Основные поля ответа JSON
Полный ответ можно увидеть в демо. Отсутствующие справочные данные могут иметь значение null; учитывайте это в интеграции.
| Поле | Значение |
|---|---|
data.phone.e164 | Нормализованный международный номер. |
data.country, data.location | Страна, регион, город и основание определения географии, если найдены. |
data.operator | Имя и бренд оператора диапазона; mnp_checked показывает, что перенос номера не проверялся. |
data.timezone | name, local_time, utc_offset_seconds, basis и список candidates. При неоднозначной географии единый часовой пояс может отсутствовать. |
Авторизация, ошибки и учёт запросов
Некорректные входные данные возвращают HTTP 422. Ошибки доступа требуют проверки ключа и его областей. При исчерпании квоты API отвечает HTTP 429 с кодом quota_exceeded; ограничения частоты запросов действуют отдельно. Ошибка провайдера возвращает зарезервированную единицу квоты.
Тарифы Phone API
Цены и квоты загружаются из действующего каталога API.
Бесплатно
0 ₽/ месяц
100запросов
Получить API-ключСтарт
299 ₽/ месяц
10 000запросов
Выбрать тарифПро
990 ₽/ месяц
100 000запросов
Выбрать тарифREST API и авторизованный MCP используют общие квоты аккаунта по каждому продукту. Бесплатный месяц считается по московскому времени. Платный период начинается после подтверждения оплаты. Заказ сам по себе не активирует пакет; оплата подтверждается вручную, автоматических списаний нет.
Вопросы о Phone API
В каком формате передавать телефон?
Передавайте phone строкой. Для международного номера используйте код страны, например +79991234567. Необязательный default_region — двухбуквенный код страны для интерпретации национального формата.
Можно ли узнать, где сейчас находится абонент?
Сервис возвращает справочную географию номера. Он не получает координаты телефона, данные о владельце или подтверждение присутствия человека в регионе.
Нужен ли отдельный ключ для CRM?
В кабинете после входа через MAX можно создать ключ для проекта со scope phone. Используйте ключ в серверной части интеграции; не публикуйте его в JavaScript сайта.