Документация API
v1
Все запросы отправляются методом POST с телом в формате JSON. В каждом запросе передавайте свой token.
https://icmp.void.ltd/v1/
Аутентификация
Токен передаётся в теле запроса в поле token. Проверить токен и баланс можно запросом на /v1/balance.
{
"token": "ваш-api-токен"
}
Цены
Базовая цена запроса — 3 ₽. При пополнении от ₽ 2 500 — 2 ₽, от ₽ 5 000 — 1 ₽ (приоритетный тариф).
Лимиты запросов
Каждый API-токен имеет лимит запросов. По умолчанию — 60 запросов в секунду.
Запросы сверх лимита ставятся в очередь, а не отклоняются. Они будут обработаны по порядку.
Для увеличения лимита обратитесь к администратору.
Ваш текущий лимит
60 запросов/сек
Эндпоинты
Доступные методы поиска. Показаны только те, что доступны вашему ключу.
POST/v1/query/get/personПоиск по человеку
Поиск по ФИО, дате рождения или документам.
| Параметр | Обязательность | Описание |
|---|---|---|
| token | обязательный | Ваш API-токен |
| country | обязательный | Код страны: RU / KZ / BY / UZ / UA |
| lastname | необязательный | Фамилия |
| firstname | необязательный | Имя |
| middlename | необязательный | Отчество |
| day | необязательный | День рождения |
| month | необязательный | Месяц рождения |
| year | необязательный | Год рождения |
| inn | необязательный | ИНН |
| passport | необязательный | Паспорт |
| snils | необязательный | СНИЛС |
| drv_ud | необязательный | Вод. удостоверение |
JSON тело
{
"token": "ваш-api-токен",
"country": "RU",
"lastname": "Иванов",
"firstname": "Иван",
"middlename": "Иванович",
"day": "15",
"month": "06",
"year": "1990"
}
Python
import requests
resp = requests.post(
"https://icmp.void.ltd/v1/query/get/person",
json={
"token": "ваш-api-токен",
"country": "RU",
"lastname": "Иванов",
"firstname": "Иван",
"middlename": "Иванович",
"day": "15",
"month": "06",
"year": "1990",
},
)
print(resp.json())
POST/v1/query/get/phoneПоиск по телефону
Информация по номеру телефона.
| Параметр | Обязательность | Описание |
|---|---|---|
| token | обязательный | Ваш API-токен |
| phone | обязательный | Номер телефона в международном формате |
JSON тело
{
"token": "ваш-api-токен",
"phone": "+79991234567"
}
POST/v1/query/get/emailПоиск по Email
Информация по адресу электронной почты.
| Параметр | Обязательность | Описание |
|---|---|---|
| token | обязательный | Ваш API-токен |
| обязательный | Email-адрес |
JSON тело
{
"token": "ваш-api-токен",
"email": "[email protected]"
}
POST/v1/query/get/autoПоиск авто
Информация по транспортному средству.
| Параметр | Обязательность | Описание |
|---|---|---|
| token | обязательный | Ваш API-токен |
| vin | необязательный | VIN-номер |
| grz | необязательный | Гос. номер |
JSON тело
{
"token": "ваш-api-токен",
"grz": "А123БВ777"
}
POST/v1/query/get/companyПоиск по компаниям
Информация по организации (ИНН/ОГРН/название).
| Параметр | Обязательность | Описание |
|---|---|---|
| token | обязательный | Ваш API-токен |
| inn | необязательный | ИНН |
| ogrn | необязательный | ОГРН |
| name | необязательный | Название |
JSON тело
{
"token": "ваш-api-токен",
"inn": "7707083893"
}
Онлайн-тест
200 OK
Ошибки
| Код | Описание |
|---|---|
| 401 | Неверный или отсутствующий токен |
| 402 | Недостаточно средств на балансе |
| 403 | Ключ отключён или не активирован |
| 429 | Превышен лимит запросов (ставится в очередь) |
| 500 | Внутренняя ошибка сервера |