Глобальный поиск оператора связи

Глобальный поиск оператора связи: миллиарды записей, своевременные обновления и высокая точность.

Пример:

curl --location --request POST 'https://api.checknumber.ai/v1/phone' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'X-API-Key: AbcdEfgh' \
--data-urlencode 'number=628138800001&country=ID'

Пример ответа для корректного запроса

{
  "status": "ok",
  "message": {
    "country_code": 62,
    "national_number": 8138800001,
    "is_valid_number": true,
    "number_type": "MOBILE",
    "e164": "+628138800001",
    "region_code": "ID",
    "location": {
      "en": ""
    },
    "time_zones": ["Asia/Jakarta"],
    "carrier": {
      "en": "AXIS"
    }
  }
}

Пример ответа для запроса с ошибкой

{
  "status": "FAIL",
  "message": "The phone number supplied is not a number."
}

HTTP-запрос

POST https://api.checknumber.ai/v1/phone

Параметры запроса

Параметр	Описание
number	string, номер телефона
country	string, код региона, например ID для Индонезии

Коды состояния

Статус	Описание
OK	free, успешно
FAIL	free, ошибка; поле message содержит текст ошибки

Описание полей номера телефона

Поле	Описание
country_code	Код страны, например 62 для Индонезии
national_number	Национальный номер
is_valid_number	Действителен ли номер
number_type	Тип номера: MOBILE или FIXED_LINE
e164	Номер в формате E.164
region_code	Код региона, например ID для Индонезии
location	Местоположение, многоязычное
time_zones	Часовые пояса
carrier	Оператор связи, многоязычное поле

Описание типов номеров телефонов

Тип	Описание
MOBILE	Мобильный телефон
FIXED_LINE	Стационарный телефон
FIXED_LINE_OR_MOBILE	Мобильный или стационарный телефон; в некоторых странах определить тип только по номеру невозможно
SHARED_COST	Услуга с разделением стоимости
VOIP	VoIP
PERSONAL_NUMBER	Персональный номер
UNKNOWN	Неизвестно