API docs by Redocly

API BigAutoData (v5)

Download OpenAPI specification:

API BigAutoData

Общая документация по ручкам. Разделы слева — по продуктам.

Все проверки асинхронные: POST создаёт задачу и возвращает task_id, GET с этим task_id забирает результат. Пока is_completed = false — результат ещё собирается, запрос нужно повторить.

Авторизация — заголовок Authorization: Basic {{TOKEN}} в каждом запросе.

Примеры ответов в этой доке — реальные, скопированные из ручек, а не придуманные.

Авторизация

Аутентификация

Для работы с BigAutoData API поддерживается авторизация через Basic Auth.

Каждый запрос должен содержать заголовок Authorization с токеном, сформированным по схеме Basic.

Как получить токен авторизации

Возьмите предоставленные логин и пароль:

Plain Text

login: i.ivanov
password: febeef37a2444b19

Объедините их в формате login:password:

Plain Text

i.ivanov:febeef37a2444b19

Закодируйте строку в Base64:

Plain Text

aS5pdmFub3Y6ZmViZWVmMzdhMjQ0NGIxOQ==

Добавьте в заголовок запроса:

Plain Text

Authorization: Basic aS5pdmFub3Y6ZmViZWVmMzdhMjQ0NGIxOQ==

Пример запроса (curl)

Plain Text

curl -X GET "https://api.bigautodata.ru/v1/example" \
  -H "Authorization: Basic aS5pdmFub3Y6ZmViZWVmMzdhMjQ0NGIxOQ==" \
  -H "Content-Type: application/json"

Важно

  • При использовании Basic Auth токен постоянный и не требует обновления.

  • Данные (логин и пароль) должны храниться в защищённом месте.

  • Заголовок Authorization обязателен для всех запросов к сервисам BigAutoData API.

Лимиты

GET v1/client/usage

Описание:

Метод возвращает данные о потреблении клиента по API. Запрос выполняется без тела и без параметров: клиент определяется по токену в заголовке Authorization.

Структура успешного ответа в сохранённых примерах коллекции отсутствует — приведён только ответ на запрос без валидной авторизации. Ответ с ошибкой авторизации приходит без конверта response: это плоский объект с единственным полем message.

Метод: GET
Endpoint: /api/v1/client/usage
Авторизация: Authorization: Basic {{TOKEN}}

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

Параметры пути и query-параметры не передаются. Тело запроса пустое.

Параметры ответа (ошибка авторизации)

Параметр Тип Описание
message string Текст ошибки

Коды ответа

Код Когда возвращается
200 Запрос выполнен успешно; пример успешного ответа в коллекции не сохранён
401 Не передан или неверный API-токен

Пример 401:

{
  "message": "Missing authorization data"
}

Сообщения валидации

Условие message
Заголовок Authorization отсутствует или не распознан Missing authorization data

Пример запроса

curl -X GET 'https://bad-api.bigautodata.ru/api/v1/client/usage' \
  --header 'Authorization: Basic {{TOKEN}}'
Authorizations:
basicAuth

Responses

Response samples

Content type
application/json
{
  • "response": {
    }
}

Автозаполнение

Общая информация

Описание: API Автозаполнение является одним из ключевых продуктов BigAutoData. Данная API позволяет получить список характеристик транспортного стредства (ТС) по VIN, ГРЗ, номеру шасси или номеру кузова.

Доступ предоставляется по запросу. Для подключения и получения ключей обратитесь к вашему менеджеру.

Коды ошибок

  • Если при обработке запроса время выполнения выходит за соответствующие продукту критические значения, API возвращает HTTP-код 200 и соответствующий ответ, в котором булевое значение is completed = false

  • Если при обработке обнаружена ошибка в запросе, API возвращает HTTP-код 200 и соответствующий ответ, в котором булевое значение is error = true, is comleted = false

  • Если токен авторизации недействителен, то API возвращает HTTP-код 401

  • Если данные о ТС не найдены, то API возвращает HTTP-код 404

Структура данных в отчете

Данные в отчете разделены на логические группы по отдельным параметрам. Размер и полнота отчета зависят от вида запрошенного отчета.

Стандратные отчеты Автозаполнения:

  • характеристики ТС

  • характеристики ТС + СТС

  • Базовое автозаполнение

  • Базовое автозаполнение + такси

  • Расширенное автозаполнение

Авторизация

Стандартная авторизация Basic Authentication

Используемые компоненты:

  • База данных bad-admin-app (учетные записи пользователей)

  • Механизм Basic Authentication

Особенности:

  • Кэширование успешных авторизаций (срок действия 24 часа)

  • Проверка статуса пользователя (IsActive)

Сравнительная таблица стандартных контрактов

Технические характеристики ТС Технические характеристики + СТС Базовое автозаполнение Базовое автозаполнение + такси Расширенное автозаполнение
Описание Самый краткий: возвращает краткий список характеристик ТС Краткий список характеристик дополнен информацией об СТС Стандартный список характеристик ТС с СТС Стандартный список характеристик ТС с СТС и такси Стандартный список характеристик ТС с СТС и такси + ПТС, ДТП, регистрация, штрафы, утилизация, розыск
категория ТС,
номер кузова, номер шасси,
модель, марка ТС, мощность двигателя (лс), год выпуска, масса ТС, макс. разреш. масса, ГРЗ, VIN		 🟢 🟢 🟢 🟢 🟢
СТС: тип документа,
дата выдачи,
номер, серия		 🟢 🟢 🟢 🟢
модификация ТС, код типа кузова,
цвет, количество дверей, сидений, тип привода, модель, номер, объем, тип, мощность двигателя (квт), руль, марка, модель, модификация ТС от Трансдекра		 🟢 🟢 🟢
тип кузова 🟢 🟢 🟢
информация о такси 🟢 🟢
ПТС: дата выдачи, номер, серия 🟢
если нет информации про СТС (редко)		 🟢
регистрация, дтп, штрафы, утилизация, розыск 🟢

🔴 Особенности поиска ТС без регистрации (отсутствует ГРЗ)

В случае, если машина еще не поставлена на учет (отсутствует ГРЗ), то подлкючается дополнительный флоу поиска таких ТС.

В ответе будет выводиться найденная информация, а поле "ГРЗ" останется незаполненным.

Автозаполнение+такси

Общая информация

Описание: возвращает стандартный список характеристик транспортного стредства (ТС), информацию о регистрации (СТС), данные по Трансдекра и наличии лицензии такси.

По дефолту выводит данные СТС. Если СТС не найдено (редко), то показывает данные ПТС.

Авторизация

Стандартная авторизация в bad-admin-app (Basic Auth)

Используемые компоненты:

  • База данных bad-admin-app (учетные записи пользователей)

  • Механизм Basic Authentication

Описание

Наименование: info_with_taxi

Метод: GET

Версия: V5

Параметры метода:

Параметр Тип Обязательный Описание
request-type string да Тип идентификатора ТС
car-id string да Значение идентификатора

Варианты request_type:

request-type Описание
number-plate ГРЗ
vin-number VIN транспортного средства
car-body-number по номеру кузова
chassis-number по номеру шасси

Параметры ответа:

Параметр Тип Описание
response object Контейнер с ответом
id string Идентификатор запроса
cost стоимость запроса (может быть null)
method string Используемый сервис
request object Контейнер для параметров, полученных в запросе
vin_number string VIN транспортного средства
is_error bool Возможные значения:

- false - ошибок нет

- true - ошибка. Если внутренняя ошибка
или ошибка источника 4ХХ
или 5ХХ ошибка, кроме
таймаута
is_completed bool Возможные значения:

- false - ошибка. Если внутренняя ошибка
или ошибка источника 4ХХ
или 5ХХ ошибка, кроме
таймаута

- true - ошибок нет
result object Контейнер, содержащий полную информацию о транспортном средстве
number_plate string ГРЗ
vin_number string VIN транспортного средства
chassis_number string Номер шасси транспортного средства
car_body_number string Номер кузова транспортного средства
manufacturing_year int Год выпуска
engine_power int/float Мощность двигателя (л.с.)
max_mass int Максимальная масса
seats_count int Количество сидений
car_type string Код типа кузова
car_model string Модель
car_mark string Марка
car_modification string Модификация
td_mark string Марка транспортного средства по нормализированному справочнику
td_model string Модель транспортного средства по нормализированному справочнику
td_modification string Модификация транспортного средства по нормализированному справочнику
power_kwt int/float Мощность двигателя, квт
engine_model string Модель двигателя
engine_number string Номер двигателя
engine_volume int Объем двигателя
car_category string Категория
color string Цвет
doors_count int Количество дверей
drive_type string Тип привода
fuel_name string Тип двигателя
weight_netto int Масса транспортного средства
steer_side string Руль
sts_series string Серия СТС
sts_number string Номер СТС
sts_issue_date string Дата регистрации СТС
taxi object Контейнер для параметров, полученных в запросе по сервису "Такси"
update_date string Дата обновления лицензии (дд.мм.гггг)
license_date string Дата создания лицензии (дд.мм.гггг)
name string Компания
ogrn_num string ОГРН
inn string ИНН
brand_model string Модель и марка транспортного средства
reg_num string ГРЗ
blank_no string Номер бланка
full_name string Полное наименование
validity_date string Срок действия лицензии (дд.мм.гггг)
region string Регион
region_num string Код региона
condition string Состояние лицензии.

Возможные значения:

- Действует

- Не действует

- Aннулировано

- Приостановлено
yellow_color int Флаг «жёлтого» цвета кузова
1 - да
0 - нет
yellow_reg_num int Флаг «жёлтого» номера
1 - да
0 - нет
used_in_taxi bool Признак использования в такси.

Возможные значения:

- false - нет

- true - да
color string Цвет
manufacturing_year string Год выпуска
norm_mark string Нормализованное значение марки ТС
norm_model string Нормализованное значение модели ТС
Authorizations:
basicAuth
path Parameters
vin_number
required
string
Example: XTA213100L0214324

Responses

Response samples

Content type
application/json
Example
{
  • "response": {
    }
}

Базовое автозаполнение

Общая информация

Описание: возвращает стандартный список характеристик транспортного стредства (ТС) и информацию о регистрации (СТС) и данные по Трансдекра.

По дефолту выводит данные СТС. Если СТС не найдено (редко), то показывает данные ПТС.

Авторизация

Стандартная авторизация в bad-admin-app (Basic Auth)

Используемые компоненты:

  • База данных bad-admin-app (учетные записи пользователей)

  • Механизм Basic Authentication

Описание

Наименование: general_info

Метод: GET

Версия: V5

Параметры метода:

Параметр Тип Обязательный Описание
request-type string да Тип идентификатора ТС
car-id string да Значение идентификатора

Варианты request_type:

request-type Описание
number-plate ГРЗ
vin-number VIN транспортного средства
car-body-number по номеру кузова
chassis-number по номеру шасси

Параметры ответа:

Параметр Тип Описание
response object Контейнер с ответом
id string Идентификатор запроса
cost int стоимость запроса (может быть null)
method string Используемый сервис
request object Контейнер для параметров, полученных в запросе
car_body_number string Номер кузова транспортного средства
is_error bool Возможные значения:

- false - ошибок нет
- true - ошибка. Если внутренняя ошибка
или ошибка источника 4ХХ
или 5ХХ ошибка, кроме
таймаута
is_completed bool Возможные значения:

- false - ошибка. Если внутренняя ошибка
или ошибка источника 4ХХ
или 5ХХ ошибка, кроме
таймаута
- true - ошибок нет
result object Контейнер, содержащий информацию о транспортном средстве
car_body_number string Номер кузова транспортного средства
car_category string Категория транспортного средства
Возможные значения:
- A
- B
- C
- D
- F
car_mark string Марка транспортного средства
car_model string Модель транспортного средства
car_modification string Модификация транспортного средства
car_type string Код типа кузова транспортного средства

Возможные значения:
Расшифровка всех возможных значений
car_type_string string Тип кузова транспортного средства
chassis_number string Номер шасси транспортного средства
color string Цвет транспортного средства
credential object Контейнер с данными о документе регистрации
credential_type string Тип документа
Возможные значения:
- СТС –VEHICLE_REGISTRATION
- ПТС – VEHICLE_PASSPORT
- ЭПТС – E_VEHICLE_PASSPORT
issue_date string Дата выдачи (формат гггг-мм-дд)
number string Номер
series string Серия
doors_count int Количество дверей
drive_type string Тип привода
engine_model string Модель двигателя
engine_number string Номер двигателя
engine_power int/float Мощность двигателя, лс
engine_volume int Объем двигателя
fuel_name string Тип двигателя
Возможные значения:
- Бензин
- Бензин/газ
- Бензин/Е85
- Водород
- Газ
- Дизель
- Дизель/газ
- Нет
- Прочие
manufacturing_year int Год выпуска
max_mass int Максимальная разрешенная масса
number_plate string ГРЗ
power_kwt int/float Мощность двигателя, квт
seats_count int Количество сидений
steer_side string Располжение руля
Возможные значения:
- left
- right
td_mark string Марка транспортного средства по нормализированному справочнику
td_model string Модель транспортного средства по нормализированному справочнику
td_modification string Модификация транспортного средства по нормализированному справочнику
vin_number string VIN
weight_netto int Масса транспортного средства
Authorizations:
basicAuth
path Parameters
number_plate
required
string
Example: Х735ЕН65
query Parameters
include_pts
required
string

Responses

Response samples

Content type
application/json
Example
{
  • "response": {
    }
}

Расширенное автозаполнение

Общая информация

Описание: возвращает cтандартный список характеристик ТС с СТС и такси + ПТС, ДТП, регистрация, штрафы, утилизация и розыск.

Авторизация

Стандартная авторизация в bad-admin-app (Basic Auth)

Используемые компоненты:

  • База данных bad-admin-app (учетные записи пользователей)

  • Механизм Basic Authentication

Описание

Наименование: info_extented

Метод: GET

Версия: V5

Параметры метода:

Параметр Тип Обязательный Описание
request-type string да Тип идентификатора ТС
car-id string да Значение идентификатора

Варианты request_type:

request-type Описание
number-plate ГРЗ
vin-number VIN транспортного средства
car-body-number по номеру кузова
chassis-number по номеру шасси

Параметры ответа:

Параметр Тип Описание
response object Контейнер с ответом
id string Идентификатор запроса
cost стоимость запроса (может быть null)
method string Используемый сервис
request object Контейнер для параметров, полученных в запросе
vin_number string VIN запроса
is_error bool Возможные значения:

- false - ошибок нет

- true - ошибка. Если внутренняя ошибка
или ошибка источника 4ХХ
или 5ХХ ошибка, кроме
таймаута
is_completed bool Возможные значения:

- false - ошибка. Если внутренняя ошибка
или ошибка источника 4ХХ
или 5ХХ ошибка, кроме
таймаута

- true - ошибок нет
result object Контейнер, содержащий полную информацию о транспортном средстве
car_details object Объект с характеристиками
doors_count int Количество дверей
fuel_name string Тип топлива
max_mass int Максимальная разрешенная масса
seats_count int Количество сидений
weight_netto int Масса транспортного средства
car_ids object Объект с идентификационными номерами и регистрационными данными
body_number string Номер кузова транспортного средства
chassis_number string Номер шасси транспортного средства
license_plate string ГРЗ
vin string VIN транспортного средства
car_spec object Объект, содержащий технические характеристики
drive_type string Тип привода
engine_model string Модель двигателя
engine_number string Номер двигателя
engine_volume int Объем двигателя
power_hp int/float Мощность двигателя, лс
power_kwt int/float Мощность двигателя, квт
vehicle_passport object Объект с документами
passport object Объект с данными ПТС
issue_date string Дата выдачи ПТС
number string Номер ПТС
series string Серия ПТС
registration object Объект с данными СТС
issue_date string Дата регистрации документа
number string Номер документа
series string Серия документа
car_view object Контейнер, содержащий характеристики транспортного средства
car_model string Модель транспортного средства
category string Категория транспортного средства
color string Цвет
mark_car string Марка транспортного средства
model_car string Модель транспортного средства
steer_side string Расположение руля
vhk_type string Код типа кузова транспортного средства
vhk_type_name string Тип кузова транспортного средства
year int Год выпуска
dtp object Контейнер для параметров, полученных в запросе по сервису "ДТП"
accident_date_time string Дата ДТП ("ГГГГ-ММ-ДД ЧЧ:ММ:СС")
accident_number string Номер ДТП
accident_place string Место ДТП
accident_type string Тип ДТП
actual_date string Дата обновления ("ГГГГ-ММ-ДД ЧЧ:ММ:СС")
codes массив Коды повреждения
damage_description string Описание повреждений
damage_points массив места повреждений
owner_okopf string Тип владельца
region_name string Наименование региона
request_time string Дата запроса
vehicle_amount string Количество участников ДТП
vehicle_damage_state string Состояние транспортного средства
vehicle_mark string Марка ТС
vehicle_model string Модель ТС
vehicle_sort string Тип транспортного средства
vehicle_year string Год выпуска ТС
fines object Контейнер для параметров, полученных в запросе по сервису "Штрафы"
alt_payer_id string
amount int Сумма штрафа
amount_to_pay int Сумма к оплате
article string Статья нарушения
article_description string Описание нарушения
certificate string Номер сертификата или документа, связанного с штрафом (может быть пустым)
decision_date string Дата нарушения ("ГГГГ-ММ-ДД ЧЧ:ММ:СС")
details string Детали нарушения
discount_date string Дата, когда действует скидка (если есть) ("ГГГГ-ММ-ДД")
discount_size int Размер скидки в процентах
dit_external_id string Внешний идентификатор системы
division_id string Идентификатор подразделения, вынесшего штраф
division_name string Наименование отделения ГИБДД
document string Документ на который выписан штраф
is_discount_active bool Признак действует ли скидка.

Возможные значения:

- true - да

- false - нет
is_paid bool Признак оплаты.

Возможные значения:

- true - оплачен

- false - не оплачен
is_revoked bool Признак аннулирования.

Возможные значения:

- true - да

- false - нет
legal_act string Акт нарушения
offense_lat string Координаты и место нарушения (latitude – широта)
offense_lon string Координаты и место нарушения (longitude – долгота),
offense_place string Координаты и место нарушения
offense_point string Координаты и место нарушения
origin_uin string Внутренний идентификатор системы
pay_status int Статус оплаты
payer_name string Имя плательщика
photo bool Признак фото.

Возможные значения:

- false - нет

- true - да
providers int Число поставщиков услуги или системы
purpose string Назначение платежа
recipient_account string расчетный счет банка (р/с)
recipient_bank_name string Наименование Банка
recipient_bic string БИК
recipient_corr_account string корреспондентский счет (к/с)
recipient_inn string ИНН
recipient_kbk string КБК
recipient_kpp string КПП
recipient_name string Наименование отделения ГИБДД
recipient_okato string ОКАТО
request_token string Токен запроса (обычно пустой)
uin string Номер штрафа
vehicle_model string Модель ТС
violation_date string Дата штрафа ("ГГГГ-ММ-ДД ЧЧ:ММ:СС")
is_utilized bool Признак утилизации.

Возможные значения:

- false - нет

- true - да
owner_type string Тип владельца.

Возможные значения:

- Legal - юридическое лицо
owner_type_extended string Наименование владельца
reg_actions object Контейнер для параметров, полученных в запросе по сервису "Регистрация"
code string Код регистрационного действия
from string Начало регистрационного действия ("ГГГГ-ММ-ДД")
name string Описание регистрационного действия
person string Описание типа владельца
person_type string Тип владельца
to string Завершение регистрационного действия ("ГГГГ-ММ-ДД")
region string Регион
restrictions Параметры, полученные в запросе по сервису "Ограничения"
taxi object Контейнер для параметров, полученных в запросе по сервису "Такси"
blank_no string Номер бланка
brand_model string Модель и марка транспортного средства
color string Цвет
condition string Состояние лицензии
full_name string Полное наименование
inn string ИНН
license_date string Дата получения лицензия (ДД.ММ.ГГГГ)
manufacturing_year int Год выпуска
name string Компания
norm_mark string Нормализованное значение марки
norm_model string Нормализованное значение модели
ogrn_num string ОГРН
reg_num string ГРЗ
region string Регион выдачи лицензии
region_num string Код региона
update_date string Дата обновления (ДД.ММ.ГГГГ)
used_in_taxi bool Признак использования в такси
validity_date string Срок действия (ДД.ММ.ГГГГ)
yellow_color int Желтый цвет
yellow_reg_num int ГРЗ желтого цвета
td object Контейнер, содержащий информацию по данным трансдекры
td_mark string Марка транспортного средства по нормализированному справочнику
td_model string Модель транспортного средства по нормализированному справочнику
td_modification string Модификация транспортного средства по нормализированному справочнику
utilisation_date string Дата утилизации
wanted Контейнер для параметров, полученных в запросе по сервису "Розыск"
Authorizations:
basicAuth
path Parameters
number_plate
required
string
Example: Х735ЕН65

Responses

Response samples

Content type
application/json
Example
{
  • "response": {
    }
}

Тех. характеристики + СТС

Общая информация

Описание: возвращает краткий список характеристик транспортного средства (ТС), дополненный информацией о регистрации (СТС)

Авторизация

Стандартная авторизация в bad-admin-app (Basic Auth)

Используемые компоненты:

  • База данных bad-admin-app (учетные записи пользователей)

  • Механизм Basic Authentication

Описание

Наименование: short_info_with_documents

Метод: GET

Версия: V5

Параметры метода:

Параметр Тип Обязательный Описание
request-type string да Тип идентификатора ТС
car-id string да Значение идентификатора

Варианты request_type:

request-type Описание
number-plate ГРЗ
vin-number VIN транспортного средства
car-body-number по номеру кузова
chassis-number по номеру шасси

Параметры ответа:

Параметр Тип Описание
response object Контейнер с ответом
id string Идентификатор запроса
cost string стоимость запроса (может быть null)
method string Используемый сервис
request object Контейнер для параметров, полученных в запросе
vin_number string VIN запроса
is_error bool Возможные значения:

- false - ошибок нет

- true - ошибка. Если внутренняя ошибка
или ошибка источника 4ХХ
или 5ХХ ошибка, кроме
таймаута
is_completed bool Возможные значения:

- false - ошибка. Если внутренняя ошибка
или ошибка источника 4ХХ
или 5ХХ ошибка, кроме
таймаута

- true - ошибок нет
result object Контейнер, содержащий полную информацию о транспортном средстве
number_plate string ГРЗ
vin_number string VIN-номер
chassis_number string Номер шасси транспортного средства
car_body_number string Номер кузова транспортного средства
car_category string Категория транспортного средства
manufacturing_year int Год выпуска транспортного средства
engine_power int/float Мощность двигателя (л.с.)
car_model string Модель транспортного средства
car_mark string Марка транспортного средства
max_mass int Максимальная разрешенная масса
weight_netto int Масса транспортного средства
credential object Контейнер с данными о документе регистрации
credential_type string Тип документа

Возможные значения:
СТС — VEHICLE_REGISTRATION
ПТС — VEHICLE_PASSPORT
ЭПТС — E_VEHICLE_PASSPORT
issue_date string Дата выдачи
number string Номер
series string Серия
Authorizations:
basicAuth
path Parameters
vin_number
required
string
Example: JTNBV56E002046048

Responses

Response samples

Content type
application/json
Example
{
  • "response": {
    }
}

Технические характеристики ТС

Общая информация

Описание: возвращает краткий список характеристик транспортного средства (ТС)

Авторизация

Стандартная авторизация в bad-admin-app (Basic Auth)

Используемые компоненты:

  • База данных bad-admin-app (учетные записи пользователей)

  • Механизм Basic Authentication

Описание

Наименование: short_info

Метод: GET

Версия: V5

Параметры метода:

Параметр Тип Обязательный Описание
request-type string да Тип идентификатора ТС
car-id string да Значение идентификатора

Варианты request_type:

request-type Описание
number-plate ГРЗ
vin-number VIN транспортного средства
car-body-number по номеру кузова
chassis-number по номеру шасси

Параметры ответа:

Параметр Тип Описание
response object Контейнер с ответом
id string Идентификатор запроса
cost int стоимость запроса (может быть null)
method string Используемый сервис
request object Контейнер для параметров,
полученных в запросе
number_plate string ГРЗ
is_error bool Типы ответов:

- false - ошибок нет

- true - ошибка. Если внутренняя ошибка
или ошибка источника 4ХХ
или 5ХХ ошибка, кроме
таймаута
is_completed bool Типы ответов:

- false - ошибка. Если внутренняя ошибка
или ошибка источника 4ХХ
или 5ХХ ошибка, кроме
таймаута

- true - ошибок нет
result object Контейнер, содержащий информацию о транспортном средстве
car_body_number string Номер кузова транспортного средства
car_category string Категория транспортного средства
car_mark string Марка транспортного средства
car_model string Модель транспортного средства
chassis_number string Номер шасси транспортного средства
engine_power int/float Мощность двигателя (л.с.)
manufacturing_year int Год выпуска
max_mass int Максимальная разрешенная масса
number_plate string ГРЗ
vin_number string VIN транспортного средства
weight_netto int Масса транспортного средства
Authorizations:
basicAuth
path Parameters
vin_number
required
string
Example: WVWZZZ13ZDV027586

Responses

Response samples

Content type
application/json
Example
{
  • "response": {
    }
}

Атрибуты и история ТС

Данные методы используются для получения конкретных характеристик ТС.

Доступ предоставляется по запросу. Для подключения и получения ключей обратитесь к вашему менеджеру.

Для запроса необходимо ввести request_type. Это могут быть разные идентификаторы ТС (например, VIN, ГРЗ, кузов, шасси, СТС и т.п.). Возможные request_type зависят от конкретного метода и указаны ниже в документации.

Коды ошибок

  • Если при обработке запроса время выполнения выходит за соответствующие продукту критические значения, API возвращает HTTP-код 200 и соответствующий ответ, в котором булевое значение is completed = false

  • Если при обработке обнаружена ошибка в запросе, API возвращает HTTP-код 200 и соответствующий ответ, в котором булевое значение is error = true, is comleted = false

  • Если токен авторизации недействителен, то API возвращает HTTP-код 401

  • Если данные о ТС не найдены, то API возвращает пустой массив []

Авторизация

Стандартная авторизация Basic Authentication

Используемые компоненты:

  • База данных bad-admin-app (учетные записи пользователей)

  • Механизм Basic Authentication

Особенности:

  • Кэширование успешных авторизаций (срок действия 24 часа)

  • Проверка статуса пользователя (IsActive)

[0] Получение информации об авто

Описание:

Метод предназначен для получения основных идентификаторов транспортного средства, а также данных по СТС и ПТС.

В ответе возвращаются: государственный регистрационный номер (ГРЗ), VIN, номер кузова, номер шасси, сведения по документам (ПТС и СТС).

Метод: GET

Endpoint: /api/v5/vehicle-fields/car-info-docs/by-vin-number/{car_id}

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

Параметр Где передаются Тип Обязателен Описание
host URL string да Корневой адрес сервиса: https://bad-api.bigautodata.ru/api/
version path string да Версия API: v5
request_type path string да Тип идентификатора ТС. Возможные значения:
• vin_number — VIN транспортного средства
• number_plate — ГРЗ
• car_body_number — номер кузова
• chassis_number — номер шасси
car_id path string да Значение идентификатора (например, VIN или ГРЗ)

Пример запроса:

curl --location 'https://bad-api.bigautodata.ru/api/v5/vehicle-fields/car-info-docs/by-vin-number/XW7BZYHK40S112140' \
--header 'accept: application/json' \
--header 'authorization: Basic <ТОКЕН>'

Параметры ответа

Параметр Тип Описание
id string Уникальный идентификатор запроса
cost string Стоимость запроса
method string Название метода: car_info
request object Контейнер с параметрами запроса
is_error bool Флаг ошибки
true – ошибка
false – ошибок нет
is_completed bool Флаг завершённости
true – успешно
false – ошибка
result array[object] Список найденных идентификаторов

Поля в result

Параметр Тип Описание
number_plate string Государственный регистрационный знак (ГРЗ)
vin_number string VIN транспортного средства
car_body_number string Номер кузова
chassis_number string Номер шасси
pts string Номер ПТС
sts string Номер СТС
Authorizations:
basicAuth
path Parameters
vin_number
required
string
Example: XW7BZYHK40S112140

Responses

Response samples

Content type
application/json
{
  • "response": {
    }
}

[1] Идентификаторы ТС

ChatGPT сказал:

Описание:

Метод предназначен для получения информации об идентификаторах транспортного средства по VIN.

В ответе возвращаются: государственный регистрационный номер (ГРЗ), VIN, номер кузова и номер шасси.

Метод: GET

Endpoint: /api/v5/vehicle-fields/car-id/by-vin-number/{car_id}

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

Параметр Где передаются Тип Обязателен Описание
host URL string да Корневой адрес сервиса: https://bad-api.bigautodata.ru/api/
version path string да Версия API: v5
request_type path string да Тип идентификатора ТС. Возможные значения:
• vin_number — VIN транспортного средства
• number_plate — ГРЗ
• car_body_number — номер кузова
• chassis_number — номер шасси
car_id path string да Значение идентификатора (например VIN: SALLMAM24AA323139)
Authorizations:
basicAuth
path Parameters
vin_number
required
string
Example: SALLMAM24AA323139

Responses

Response samples

Content type
application/json
{
  • "response": {
    }
}

Лошадиные силы

Описание:

Метод предназначен для получения информации о мощности двигателя в лошадиных силах по VIN транспортного средства.

Метод: GET

Endpoint: /api/v5/vehicle-fields/engine-power/by-vin-number/{car_id}

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

Параметр Где передаются Тип Обязателен Описание
host URL string да Корневой адрес сервиса: https://bad-api.bigautodata.ru/api/
version path string да Версия API: v5
request_type path string да Тип идентификатора ТС.
• vin_number — VIN транспортного средства
car_id path string да Значение VIN (например: SALLMAM24AA323139)

Пример запроса:

curl --location 'https://bad-api.bigautodata.ru/api/v5/vehicle-fields/engine-power/by-vin-number/SALLMAM24AA323139' \
--header 'accept: application/json' \
--header 'authorization: Basic <ТОКЕН>'

Параметры ответа

Параметр Тип Описание
id string Уникальный идентификатор запроса
cost string Стоимость запроса
method string Название метода: power_hp
is_error bool Флаг ошибки
true – ошибка
false – ошибок нет
is_completed bool Флаг завершённости
true – успешно
false – ошибка
request object Контейнер с параметрами запроса
request.vin_number string VIN транспортного средства
request_time string Дата и время выполнения запроса
result array[object] Контейнер с данными о мощности двигателя

Поля в result

Параметр Тип Описание
engine_power int Мощность двигателя в лошадиных силах
Authorizations:
basicAuth
path Parameters
vin_number
required
string
Example: SALLMAM24AA323139

Responses

Response samples

Content type
application/json
{
  • "response": {
    }
}

Номер ПТС

Описание:

Метод предназначен для получения данных о ПТС транспортного средства по VIN.

Метод: GET

Endpoint: /api/v5/vehicle-fields/pts/by-vin-number/{car_id}

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

Параметр Где передаются Тип Обязателен Описание
host URL string да Корневой адрес сервиса: https://bad-api.bigautodata.ru
version path string да Версия API: v5
request_type path string да Тип идентификатора ТС.
car_id path string да Значение идентификатора (например VIN: XW7BZYHK40S112140)

Варианты request_type:

request-type описание
number-plate ГРЗ
vin-number VIN транспортного средства
car-body-number по номеру кузова
chassis-number по номеру шасси

Пример запроса:

curl --location 'https://bad-api.bigautodata.ru/api/v5/vehicle-fields/pts/by-vin-number/XW7BZYHK40S112140' \
--header 'accept: application/json' \
--header 'authorization: Basic <ТОКЕН>'

Параметры ответа

Параметр Тип Описание
id string Уникальный идентификатор запроса
cost string Стоимость запроса (null)
method string Название метода: pts
request object Контейнер с параметрами запроса
request.vin_number string VIN транспортного средства
is_error bool Флаг ошибки
Возможные значения:
false - ошибок нет
true - ошибка. Если внутренняя ошибка
или ошибка источника 4ХХ
или 5ХХ ошибка, кроме
таймаута
is_completed bool Флаг завершённости
Возможные значения:
false - ошибок нет
true - ошибка. Если внутренняя ошибка
или ошибка источника 4ХХ
или 5ХХ ошибка, кроме
таймаута
result array Контейнер с данными по ПТС

Поля в result

Параметр Тип Описание
pts string Серия и номер ПТС
pts-date string Дата выдачи ПТС (в формате YYYY-MM-DD)

Вернем success в случаях, когда

  1. найдены все значения

  2. найдены только серия/номер, а дата пустая

  3. если все источники отработали, но ничего не найдено, то вернем успех и пустой массив.

Authorizations:
basicAuth
path Parameters
vin_number
required
string
Example: KNANC81BBMS127937

Responses

Response samples

Content type
application/json
{
  • "response": {
    }
}

Дубликат ПТС

Описание:

Метод предназначен для получения информации о наличии дубликата ПТС по VIN транспортного средства.

Метод: GET

Endpoint: /api/v5/vehicle-fields/passport-duplicate/by-vin-number/{car_id}

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

Параметр Где передаются Тип Обязателен Описание
host URL string да Корневой адрес сервиса: https://bad-api.bigautodata.ru/api/
version path string да Версия API: v5
request_type path string да Тип идентификатора ТС. Возможные значения:
• vin_number — VIN транспортного средства
car_id path string да Значение VIN (например: XTA210610G1556195)

Пример запроса:

curl -X 'GET' \
  'https://bad-api.bigautodata.ru/api/v5/vehicle-fields/passport-duplicate/by-vin-number/XTA210610G1556195' \
  -H 'Authorization: Basic <ТОКЕН>' \
  -H 'content-type: application/json'

Параметры ответа

Параметр Тип Описание
id string Уникальный идентификатор запроса
cost string Стоимость запроса
method string Название метода: registrations
is_error bool Флаг ошибки
true – ошибка
false – ошибок нет
is_completed bool Флаг завершённости
true – успешно
false – ошибка
request object Контейнер с параметрами запроса
request.vin_number string VIN транспортного средства
request_time string Дата и время выполнения запроса
result array[object] Контейнер с данными о ПТС

Поля в result

Параметр Тип Описание
pts_duplicate bool Признак дубликата ПТС
true – дубликат присутствует
false – дубликат отсутствует
Authorizations:
basicAuth
path Parameters
vin_number
required
string
Example: XTA213100L0214324

Responses

Response samples

Content type
application/json
{
  • "response": {
    }
}

Номер СТС

Описание:

Метод предназначен для получения данных о СТС (свидетельство о регистрации транспортного средства) по VIN или ГРЗ.

В ответе возвращаются серия и номер СТС, дата выдачи, а также марка и модель автомобиля.

Метод: GET

Endpoint: /api/v5/documents/sts/document/by-vin-number/{car_id}

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

Параметр Где передаются Тип Обязателен Описание
host URL string да Корневой адрес сервиса: https://bad-api.bigautodata.ru/api/
version path string да Версия API: v5
request_type path string да Тип идентификатора ТС. Возможные значения:
• vin_number — VIN транспортного средства
• number_plate — ГРЗ
car_id path string да Значение идентификатора (например VIN: Z94G2813BKR170705)

Пример запроса:

curl --location 'https://bad-api.bigautodata.ru/api/v5/documents/sts/document/by-vin-number/Z94G2813BKR170705' \
--header 'Authorization: Basic <ТОКЕН>' \
--header 'content-type: application/json'

Параметры ответа

Параметр Тип Описание
id string Уникальный идентификатор запроса
cost string Стоимость запроса
method string Название метода: sts
request object Контейнер с параметрами запроса
request.vin_number string VIN транспортного средства
request.date string Дата запроса
is_error bool Флаг ошибки
true – ошибка
false – ошибок нет
is_completed bool Флаг завершённости
true – успешно
false – ошибка
result array[object] Контейнер с данными по СТС

Поля в result

Параметр Тип Описание
series string Серия СТС
number string Номер СТС
car_mark string Марка автомобиля
car_model string Модель автомобиля
date string (yyyy-MM-dd) Дата выдачи СТС
Authorizations:
basicAuth
path Parameters
vin_number
required
string
Example: XW7BZYHK40S112140

Responses

Response samples

Content type
application/json
{
  • "response": {
    }
}

Утилизация

Описание:

Метод предназначен для получения информации об утилизации транспортного средства по VIN или другому идентификатору.

В ответе можно определить, был ли автомобиль утилизирован, а также дату утилизации (если доступна).

Метод: GET

Endpoint: /api/v5/vehicle-fields/utilization/by-vin-number/{car_id}

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

Параметр Где передаются Тип Обязателен Описание
host URL string да Корневой адрес сервиса: https://bad-api.bigautodata.ru/api/
version path string да Версия API: v5
request_type path string да Тип идентификатора ТС. Возможные значения:
• vin_number — VIN транспортного средства
• number_plate — ГРЗ
• car_body_number — номер кузова
• chassis_number — номер шасси
car_id path string да Значение идентификатора (например VIN: SALLMAM24AA323139)

Пример запроса:

curl --location 'https://bad-api.bigautodata.ru/api/v5/vehicle-fields/utilization/by-vin-number/SALLMAM24AA323139' \
--header 'accept: application/json' \
--header 'authorization: Basic <ТОКЕН>'

Параметры ответа

Параметр Тип Описание
id string Уникальный идентификатор запроса
cost string Стоимость запроса
method string Название метода: utilization
request object Контейнер с параметрами запроса
request.vin_number string VIN транспортного средства
is_error bool Флаг ошибки
true – ошибка
false – ошибок нет
is_completed bool Флаг завершённости
true – успешно
false – ошибка
result array[object] Контейнер с информацией об утилизации

Поля в result

Параметр Тип Описание
is_utilized bool Признак утилизации
true – автомобиль утилизирован
false – автомобиль не утилизирован
utilization_date string (yyyy-MM-dd) Дата утилизации, если доступна
Authorizations:
basicAuth
path Parameters
vin_number
required
string
Example: SALLMAM24AA323139

Responses

Response samples

Content type
application/json
{
  • "response": {
    }
}

Информация о документах ТС

Описание:

Метод предназначен для получения информации о регистрационных документах транспортного средства по VIN или другому идентификатору.

В ответе можно получить сведения по СТС и ПТС, а также базовые характеристики автомобиля, технические данные и идентификаторы ТС.

Метод: GET
Endpoint: /api/v5/vehicle/info-credential/by-vin-number/{car_id}

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

Параметр Где передаются Тип Обязателен Описание
host URL string да Корневой адрес сервиса: https://bad-api.bigautodata.ru/api/
version path string да Версия API: v5
request_type path string да Тип идентификатора ТС. Возможные значения: vin_number — VIN транспортного средства number_plate — ГРЗ car_body_number — номер кузова chassis_number — номер шасси
car_id path string да Значение идентификатора ТС (например VIN: SALLMAM24AA323139)

Параметры ответа

Параметр Тип Описание
id string Уникальный идентификатор запроса
cost string / null Стоимость запроса
method string Название метода: info_credential
request object Контейнер с параметрами запроса
request.vin_number string VIN транспортного средства
is_error bool Флаг ошибки true — ошибка false — ошибок нет
is_completed bool Флаг завершённости true — успешно false — ошибка
result array[object] Контейнер с информацией о документах и характеристиках ТС

Поля в result

car_ids

Параметр Тип Описание
number_plate string Государственный регистрационный номер
vin_number string VIN транспортного средства
car_body_number string Номер кузова
chassis_number string Номер шасси

credential.vehicle_registration

Параметр Тип Описание
issue_date string (yyyy-MM-dd) Дата выдачи СТС
number string Номер СТС
series string Серия СТС

credential.vehicle_passport

Параметр Тип Описание
issue_date string (yyyy-MM-dd) Дата выдачи ПТС
number string Номер ПТС
series string Серия ПТС

car_view

Параметр Тип Описание
car_category string Категория транспортного средства
car_type string Код типа транспортного средства
car_type_string string Текстовое описание типа транспортного средства
color string Цвет транспортного средства
manufacturing_year integer Год выпуска

car_spec

Параметр Тип Описание
engine_model string Модель двигателя
engine_number string Номер двигателя
engine_power integer Мощность двигателя в л.с.
power_kwt number Мощность двигателя в кВт

car_details

Параметр Тип Описание
fuel_name string Тип топлива
max_mass integer Разрешённая максимальная масса
weight_netto integer Масса без нагрузки
Authorizations:
basicAuth
path Parameters
vin_number
required
string
Example: SALLMAM24AA323139

Responses

Response samples

Content type
application/json
{
  • "response": {
    }
}

ГИБДД

Группа методов gibdd/vehicle/... предназначена для получения информации о транспортных средствах по VIN.

Сервисы используют официальные источники данных (ГИБДД и др.) и возвращают сведения о ДТП, регистрациях, ограничениях, розыске и смене владельца.

Поддерживается доступ как к актуальным данным через внешние источники, так и к локальному кэшу, что позволяет ускорять ответы и снижать нагрузку на источники.

Поддерживаемые сценарии

Типы запроса: <code>type</code>

Поддерживаемые сценарии

Среди поддерживаемых сценариев:

  • Проверка истории ДТП и участников аварий

  • Получение регистрационных сведений и периодов владения

  • Информация о нахождении в розыске

  • Данные о наложенных ограничениях

  • История смены владельца по VIN

Типы запроса: type

Во всех методах предусмотрен параметр type, который управляет источником получения данных. Возможные значения:

Значение Поведение запроса
online Только внешний источник. Кэш не используется ни на входе, ни на выходе
cache Только кэш. Обращение к источнику не происходит
cache+online Сначала проверяется кэш. Если данных нет, запрос уходит в источник
online+cache Сначала обращение к источнику. Если данных нет, пробуем кэш

Последовательность в type определяет порядок обращения к кэшу и внешним источникам.

Последние изменения

Добавлен параметр timeout — необязательный параметр для управления временем ожидания ответа от внешнего источника.

Работает только в режиме online+cache. В остальных режимах параметр игнорируется.

Как это работает: при запросе с type = online+cache сервер сначала обращается к внешнему источнику (ГИБДД). Параметр timeout задаёт максимальное время ожидания ответа от источника. Если источник не ответил за указанное время — возвращается результат из кэша (при наличии).

  • Передаётся в теле запроса (body)
  • Принимает целое число от 1 до 60 (секунды)
  • Если не указан, используется значение по умолчанию — 60 секунд

Затронутые эндпоинты:

  • /v5/gibdd/vehicle/dtp-with-participants/by-vin-number-ext/{vin}
  • /v5/gibdd/vehicle/dtp-with-participants/by-vin-number/{vin}
  • /v5/gibdd/vehicle/dtp/by-vin-number/{vin}
  • /v5/gibdd/vehicle/registrations/by-vin-number/{vin}
  • /v5/gibdd/vehicle/restricted/by-vin-number/{vin}
  • /v5/gibdd/vehicle/wanted/by-vin-number/{vin}

Общие сведения

  • Версия API: v5

  • Формат: JSON

  • Авторизация**:** Basic в заголовке Authorization. Требуется наличие активной учётной записи

  • Базовый URL: https://bad-api.bigautodata.ru/api/

Регистрации

Описание:

Метод предназначен для получения данных о регистрации транспортного средства по VIN, включая технические характеристики автомобиля и историю владения.

Сервис позволяет определить все периоды регистрации, смену владельцев и связанные операции.

Что вы получите:

  • Подробная хронология всех регистраций транспортного средства:

    • Даты начала и окончания владения

    • Тип владельца (физическое/юридическое лицо)

    • Причины смены собственника – через поля last_operation и last_operation_name

  • Расширенные технические характеристики:

    • Категория ТС (category)

    • Тип ТС (type, type_name)

    • Номер двигателя (engine_number)

    • Паспорт ТС (номер и орган выдачи)

  • Все базовые данные также включены: VIN, цвет, мощность, модель, год выпуска, объём двигателя и пр.

Метод: POST

Endpoint: /api/v5/gibdd/vehicle/registrations/by-vin-number/{vin}

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

Параметр Тип Обязателен Описание
vin string да VIN транспортного средства (вставляется в URL)
type string да Источник данных: "online", "cache", "cache+online", "online+cache"
timeout int нет Таймаут ожидания ответа от внешнего источника (в секундах). Работает только в режиме online+cache. Допускаются только целые числа от 1 до 60. По умолчанию: 60

Последовательность в type определяет порядок обращения к кэшу и внешним источникам.

Параметры ответа

Параметр Тип Описание
id string Уникальный идентификатор запроса
cost string Стоимость запроса
method string Название метода: registrations
request object Параметры запроса
vin_number string VIN транспортного средства
is_error bool Флаг ошибки
true - ошибка
false - нет
is_completed bool Успешность выполнения
true - успех
false - ошибка
result[] array Массив объектов с данными о транспортном средстве и регистрациях

Поля в result[].vehicle

Параметр Тип Описание
vin string VIN ТС
model_car string Модель ТС
body_number string Номер кузова
chassis_number string Номер шасси
year int Год выпуска
category string Категория ТС
engine_volume int Объём двигателя (см³)
color string Цвет ТС
norm_color string Нормализованный цвет
engine_number string Номер двигателя
power_kwt float Мощность двигателя (кВт)
power_hp int Мощность двигателя (л.с.)
type string Тип ТС
type_name string Наименование категории ТС
vehicle_passport.issue string Орган, выдавший ПТС
vehicle_passport.number string Номер ПТС

Поля в result[].ownership_periods[]

Параметр Тип Описание
period_start string Дата начала владения
period_end string Дата окончания владения (может быть пустой)
person_type string Тип владельца
Natural
extended_person_type string Расширенное описание типа владельца
last_operation string Код последней регистрационной операции (например, смена владельца, регистрация и т.д.)
last_operation_name string Текстовое описание последней операции, удобно для отображения пользователю
Authorizations:
basicAuth
path Parameters
vin_number
required
string
Example: KNAMC81ABLS656856
Request Body schema: application/json
required
type
required
string

Источник данных: "online", "cache", "cache+online", "online+cache"

timeout
required
integer

Таймаут ожидания ответа от внешнего источника (в секундах). Работает только в режиме online+cache. Допускаются только целые числа от 1 до 60. По умолчанию: 60

Responses

Request samples

Content type
application/json
{
  • "type": "cache+online",
  • "timeout": 30
}

Response samples

Content type
application/json
{
  • "response": {
    }
}

Смена собственника

Описание:

Метод предназначен для получения информации о смене собственника транспортного средства за заданный период в месяцах.

Сервис позволяет определить, была ли смена владельца ТС по VIN за указанный временной интервал.

Метод: POST

Endpoint: /api/v5/gibdd/owner-change/by-period

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

Параметр Где передаются Тип Обязателен Описание
month body int да Количество месяцев, за которые нужно проверить смену собственника
vin body string да VIN транспортного средства

Параметры ответа

Параметр Тип Описание
id string Уникальный идентификатор запроса
cost string Стоимость запроса
method string Название метода: owner_change_by_period
request object Контейнер с параметрами запроса
is_error bool Флаг ошибки
true - ошибка
false - нет
is_completed bool Успешность выполнения
true - успехfalse - ошибка
result object Информация о смене собственника

Поля в result

Параметр Тип Описание
is_owner_changed bool Признак смены собственника
true - была смена
false - не найдена
owner_change_date string Дата смены собственника
policy_start_date string Дата начала действия полиса (если доступна)
vin string VIN транспортного средства
Authorizations:
basicAuth
Request Body schema: application/json
required
month
required
integer

Количество месяцев, за которые нужно проверить смену собственника

vin
required
string

VIN транспортного средства

Responses

Request samples

Content type
application/json
{
  • "month": 72,
  • "vin": "JTNBV56E002046048"
}

Response samples

Content type
application/json
Example
{
  • "response": {
    }
}

ДТП+участники (расширенные)

Описание:

Метод предназначен для получения информации о дорожно-транспортных происшествиях (ДТП) с участием указанного транспортного средства по VIN.

Сервис предоставляет расширенные данные об авариях и участниках, включая место, дату, тип происшествия и сведения о повреждениях.

Метод: POST

Endpoint: /api/v5/gibdd/vehicle/dtp-with-participants/by-vin-number-ext/{vin}

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

Параметр Тип Обязателен Описание
vin string да VIN транспортного средства (вставляется в URL)
type string да Источник данных: "online", "cache", "cache+online", "online+cache"
timeout int нет Таймаут ожидания ответа от внешнего источника (в секундах). Работает только в режиме online+cache. Допускаются только целые числа от 1 до 60. По умолчанию: 60

Последовательность в type определяет порядок обращения к кэшу и внешним источникам.

Параметры ответа

Поле Тип Описание
id string Уникальный идентификатор запроса
cost string/null Стоимость запроса (если применимо)
method string Название метода: dtp_with_participants_extended
request object Параметры запроса
vin_number string VIN транспортного средства
is_error bool true – при ошибке
false – ошибок нет
is_completed bool true – запрос успешно выполнен
result[] array Список происшествий с участием ТС

Поля в result[]

Поле Тип Описание
vehicle_amount string Количество ТС, участвовавших в ДТП
accident_place string Место происшествия (город, регион и т.д.)
accident_type string Тип происшествия (например, «Столкновение»)
accident_date_time string Дата и время ДТП (формат: ДД.ММ.ГГГГ ЧЧ:мм)
accident_number string Идентификатор происшествия
region_name string Регион, где зафиксировано ДТП
participants[] array Список участников происшествия

Поля в participants[]

Поле Тип Описание
vehicle string VIN участника
damage_points[] array Коды зон повреждения (например, 114, 120)
vehicle_model string Модель автомобиля
vehicle_mark string Марка автомобиля
vehicle_damage_state string Состояние после ДТП (например, «Повреждено»)
damage_description string Текстовое описание повреждений (если есть, часто пустое)
owner_okopf string Тип собственника (например, «ФИЗИЧЕСКИЕ ЛИЦА»)
vehicle_sort string Код категории ТС (напр. 1, 2)
Authorizations:
basicAuth
path Parameters
vin_number_ext
required
string
Example: VF3GCKFWC8N046815
Request Body schema: application/json
required
type
required
string

Источник данных: "online", "cache", "cache+online", "online+cache"

timeout
required
integer

Таймаут ожидания ответа от внешнего источника (в секундах). Работает только в режиме online+cache. Допускаются только целые числа от 1 до 60. По умолчанию: 60

Responses

Request samples

Content type
application/json
{
  • "type": "cache+online",
  • "timeout": 30
}

Response samples

Content type
application/json
{
  • "response": {
    }
}

ДТП+участники

Описание:

Метод предназначен для получения информации о ДТП с участием транспортного средства по VIN.

Сервис возвращает краткие сведения о происшествиях: дату, место, количество ТС и список VIN-ов участников.

  • Метод: POST

  • Endpoint: /api/v5/gibdd/vehicle/dtp-with-participants/by-vin-number/{vin}

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

Параметр Тип Обязателен Описание
vin string да VIN транспортного средства (вставляется в URL)
type string да Источник данных: "online", "cache", "cache+online", "online+cache"
timeout int нет Таймаут ожидания ответа от внешнего источника (в секундах). Работает только в режиме online+cache. Допускаются только целые числа от 1 до 60. По умолчанию: 60

Последовательность в type определяет порядок обращения к кэшу и внешним источникам.

Параметры ответа

Тип Описание
id string Уникальный идентификатор запроса
cost string/null Стоимость запроса (если применимо)
method string Название метода: dtp_with_participants
request object Параметры входящего запроса
vin_number string VIN, по которому выполнялся запрос
is_error bool true – ошибка,false – ошибок нет
is_completed bool true – запрос успешно выполнен
result[] array Список происшествий с участием ТС

Поля в result[]

Поле Тип Описание
accident_date_time string Дата и время происшествия (формат: ДД.ММ.ГГГГ ЧЧ:мм)
accident_place string Регион или место происшествия
vehicle_amount string Общее количество ТС, участвовавших в аварии
participants[] array VIN-номера всех участников происшествия
Authorizations:
basicAuth
path Parameters
vin_number
required
string
Example: 1GNDT13S7
Request Body schema: application/json
required
type
required
string

Источник данных: "online", "cache", "cache+online", "online+cache"

timeout
required
integer

Таймаут ожидания ответа от внешнего источника (в секундах). Работает только в режиме online+cache. Допускаются только целые числа от 1 до 60. По умолчанию: 60

Responses

Request samples

Content type
application/json
{
  • "type": "online_cache",
  • "timeout": 1
}

Response samples

Content type
application/json
{
  • "response": {
    }
}

ДТП

Описание:

Метод предназначен для получения сведений о дорожно-транспортных происшествиях (ДТП) с участием указанного транспортного средства по VIN.

Сервис возвращает подробную информацию об авариях, включая дату, место, тип происшествия и характеристики транспортного средства.

Метод: POST

Endpoint: /api/v5/gibdd/vehicle/dtp/by-vin-number/{vin}

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

Параметр Тип Обязателен Описание
vin string да VIN транспортного средства (вставляется в URL)
type string да Источник данных: "online", "cache", "cache+online", "online+cache"
timeout int нет Таймаут ожидания ответа от внешнего источника (в секундах). Работает только в режиме online+cache. Допускаются только целые числа от 1 до 60. По умолчанию: 60

Последовательность в type определяет порядок обращения к кэшу и внешним источникам.

Параметры ответа

Параметр Тип Описание
id string Уникальный идентификатор запроса
cost string Стоимость запроса
method string Название метода: dtp
request object Параметры запроса
vin_number string VIN транспортного средства
is_error bool Флаг ошибки
true - ошибка
false - нет
is_completed bool Успешность выполнения
false - ошибка
true - успех
result[] array Массив записей о ДТП

Поля в result[]

Параметр Тип Описание
accident_date_time string Дата и время происшествия
accident_number string Номер происшествия
accident_place string Место происшествия
accident_type string Тип происшествия
damage_description string Описание повреждений
damage_points[] array Коды повреждений
owner_okopf string Тип владельца ТС
region_name string Регион происшествия
request_time string Время запроса
vehicle_amount int Количество транспортных средств в ДТП
vehicle_damage_state string Состояние ТС
vehicle_mark string Марка ТС
vehicle_model string Модель ТС
vehicle_sort string Тип ТС
vehicle_year int Год выпуска ТС
Authorizations:
basicAuth
path Parameters
vin_number
required
string
Example: VF3GCKFWC8N046815
Request Body schema: application/json
required
type
required
string

Источник данных: "online", "cache", "cache+online", "online+cache"

timeout
required
integer

Таймаут ожидания ответа от внешнего источника (в секундах). Работает только в режиме online+cache. Допускаются только целые числа от 1 до 60. По умолчанию: 60

Responses

Request samples

Content type
application/json
{
  • "type": "online+cache",
  • "timeout": 1
}

Response samples

Content type
application/json
{
  • "response": {
    }
}

Пробеги

Описание

Метод предназначен для получения истории пробегов автомобиля по VIN-номеру.
Сервис возвращает данные о пробегах, зафиксированных при прохождении технического осмотра.

Общая информация

Параметр Значение
Метод POST
Endpoint /api/v5/vehicle-fields/mileages/by-vin-number/{vin}

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

Параметр Где передают Тип Обязателен Описание
vin path string да VIN-номер автомобиля (17 символов)

Параметры ответа

Параметр Тип Описание
id string Уникальный идентификатор запроса
cost string Стоимость запроса
method string Название метода: mileage
request object Контейнер с параметрами запроса
is_error bool Флаг ошибки (true - ошибка, false - нет)
is_completed bool Успешность выполнения (true - успех, false - ошибка)
result array Массив записей о пробегах

Поля в result

Параметр Тип Описание
car_body string Номер кузова
car_chassis string Номер шасси
car_mileage integer Пробег автомобиля (км)
car_number string Государственный регистрационный знак
car_vin string VIN-номер автомобиля
date_of_diagnosis string Дата прохождения ТО (ДД.ММ.ГГГГ)
date_of_validity string Дата окончания действия диагностической карты (ДД.ММ.ГГГГ)
eaisto_number string Номер записи в ЕАИСТО
is_valid bool Действительность диагностической карты (true - действительна)
operator_number string Номер оператора ТО
region string Регион прохождения ТО

Примечания

  • VIN-номер передаётся в URL (path parameter)

  • Записи отсортированы по дате прохождения ТО (от новых к старым)

  • Пробег указан в километрах

  • Позволяет отследить историю пробега и выявить возможное скручивание

Authorizations:
basicAuth
path Parameters
vin_number
required
string
Example: XWEGU413BL0015330

Responses

Response samples

Content type
application/json
{
  • "response": {
    }
}

ДТП картинки

Описание:

Метод предназначен для получения схемы повреждений транспортного средства по кодам damage_points одного ДТП. Сервис декодирует коды, определяет тип ТС и возвращает изображение (SVG) с отмеченными местами повреждений.

Метод stateless: клиент передаёт коды, полученные ранее (например, из метода dtp). С вызовом метода ДТП технически не связан, обращений к внешним источникам и кэшу нет — рендер детерминированный.

Метод: POST
Endpoint: /api/v5/gibdd/vehicle/dtp-image
Авторизация: Authorization: Basic {{TOKEN}}

Параметры запроса (body)

Параметр Тип Обязателен Описание
damage_points[] array of string да Массив трёхзначных кодов повреждений одного ДТП. Формат кода ABC: A — степень повреждения, BC — место повреждения

Логика кодов:

A (степень) Значение
0 Специальные коды (001–006), к месту не привязаны
1 Повреждения без изменения геометрии кузова (стёкла, фары, колёса, ЛКП)
2 Повреждения с изменением геометрии кузова (вмятины, заломы, разрывы)
BC (диапазон) Тип ТС Шаблон
10–25 Легковое ТС car
30–43 Автобус bus
50–55 Мототранспорт motorcycle
60–80 Грузовое ТС truck
90–99 Общие коды автобуса и грузовика bus / truck

Коды мест из разных диапазонов в одном запросе — ошибка валидации. Коды 90–99 совместимы с bus и truck; специальные 001–006 — с любым типом.

Параметры ответа

Параметр Тип Описание
id string Уникальный идентификатор запроса
cost string Стоимость запроса
method string Название метода: dtp-image
request object Параметры запроса
damage_points[] array Переданные коды повреждений
is_error bool Флаг ошибки: true — ошибка, false — нет
is_completed bool Успешность выполнения: true — успех, false — ошибка
result[] array Массив результата, всегда один элемент

Поля в result[]

Параметр Тип Описание
image string Изображение схемы повреждений в формате SVG (viewBox 1000×560, перед ТС справа, левый борт сверху)

Правила отрисовки

  • Одно место — один маркер, независимо от числа вхождений кода в массив.

  • При разных степенях по одному месту цвет маркера берётся по наибольшей: "114" + "214" → один красный маркер.

  • Цвет маркера: степень 1 — оранжевый, степень 2 — красный.

  • Специальные коды 001–006 маркером не отображаются — наносятся текстовой плашкой в левом верхнем углу, дубли схлопываются, порядок по возрастанию кода.

  • Отдельные коды маркера не имеют (днище: 25 / 43 / 80, а также 99) — при запросе только из них возвращается чистый шаблон без маркеров, is_error: false.

Коды ответа

Код Когда возвращается Пример
200 Картинка сформирована, все коды валидны { "response": { "id": "65465465465", "cost": null, "method": "dtp-image", "is_error": false, "is_completed": true, "request": { "damage_points": ["114", "115", "124"] }, "result": [ { "image": "http://www.w3.org/2000/svg" viewBox="0 0 1000 560">..." } ] } }
400 Запрос не прошёл валидацию { "response": { "id": "65465465465", "cost": null, "method": "dtp-image", "is_error": true, "is_completed": false, "request": null, "result": [ { "error_code": 2, "message": "damage_points is required" } ] } }
401 Не передан или неверный API-токен —

Сообщения валидации

Условие message
damage_points отсутствует или пустой массив damage_points is required
Элемент не строка из трёх цифр damage_points must be an array of 3-digit strings
Невалидный JSON / неверный тип поля invalid payload format
Код вне справочника (148, 27, 007 и т.п.) unknown damage code: 148
Коды мест из разных диапазонов типов ТС damage_points contain codes of different vehicle types

Коды ошибок (error_code)

Код Имя Описание retry
1 InternalError Внутренняя ошибка false
2 InvalidPayload Ошибка валидации входных данных (damage_points) false
3 ExternalGeneral Ошибка вызова микросервиса (timeout, 5xx) true

Пример запроса

curl -X POST 'https://bad-api.bigautodata.ru/api/v5/gibdd/vehicle/dtp-image' \
  --header 'Authorization: Basic {{TOKEN}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "damage_points": ["114", "115", "124"]
  }'
Authorizations:
basicAuth
Request Body schema: application/json
required
damage_points
required
Array of strings

места повреждений

Responses

Request samples

Content type
application/json
{
  • "damage_points": [
    ]
}

Response samples

Content type
application/json
Example
{
  • "response": {
    }
}

История владения и юридические статусы

Регистрации без данных о причине смены собственника

Описание

Метод предоставляет сведения о регистрационных действиях с транспортным средством без внутренних кодов операций.

Что вы получите:

  • Хронология владения: даты, тип владельца (физ./юр.)

  • Основные технические параметры: VIN, модель, цвет, год, объём, мощность

  • Без:

    • категорий и типа ТС

    • номера двигателя

    • расшифровки регистрационных операций (last_operation_name)

    • данных ПТС

Метод: POST
URL: https://bad-api.bigautodata.ru/api/v5/gibdd/vehicle/reg-actions-no-codes/by-vin-number/{vin}

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

Параметр Тип Обязателен Описание
vin_number string да VIN транспортного средства (в URL)
type string да Режим получения данных:
– online
– cache
– cache+online
– online+cache

Параметры ответа

Поле Тип Описание
id string Уникальный идентификатор запроса
cost string Стоимость запроса
method string Название метода: ownershipNew
request object Параметры входного запроса
vin_number string VIN ТС
is_error bool true — ошибка (сетевая или логическая); false — успешно
is_completed bool true — запрос выполнен успешно
result[] array Основной результат — массив с данными по ТС

Поля в result[].vehicle

Поле Тип Описание
vin string VIN транспортного средства
model_car string Модель автомобиля
body_number string Номер кузова
chassis_number string Номер шасси
year string Год выпуска
category string Категория ТС
engine_volume int Объём двигателя
color string Цвет
norm_color string Стандартизированное название цвета
engine_number string Номер двигателя
power_kwt float Мощность в кВт
power_hp int Мощность в л.с.
type string Код типа ТС
type_name string Текстовое название категории
vehicle_passport object Пустой или содержащий данные ПТС (в v5 часто не заполняется)

Поля в ownership_periods[]

Поле Тип Описание
period_start string Начало владения
period_end string Конец владения (может быть пустым)
person_type string Тип субъекта (Natural – физлицо)
extended_person_type string Расширенное описание владельца
last_operation string Код операции
last_operation_name string Описание последней операции
Authorizations:
basicAuth
path Parameters
vin_number
required
string
Example: 4T1BK3EK4BU627614
Request Body schema: application/json
required
type
required
string

Источник данных: "online", "cache", "cache+online", "online+cache"

Responses

Request samples

Content type
application/json
{
  • "type": "cache+online"
}

Response samples

Content type
application/json
{
  • "response": {
    }
}

Регистрации гибридные

Описание

Общая информация

Описание: получение информации о регистрационных периодах по идентификатору ТС:

  • для леворульных машин по VIN

  • для праворульных по номеру шасси или кузову

Авторизация:

Стандартная авторизация в bad-admin-app (Basic Auth)

Используемые компоненты:

  • База данных bad-admin-app (учетные записи пользователей)

  • Механизм Basic Authentication

Метод позволяет получить информацию о регистрационных периодах транспортного средства вне зависимости от типа идентификатора (VIN / номер шасси / кузова).

Это особенно актуально для праворульных машин, где VIN может отсутствовать, а идентификация осуществляется по другим полям.

Сервис возвращает историю владения, основные характеристики ТС и структуру регистрационных операций.

Метод: POST
URL: https://bad-api.bigautodata.ru/api/v5/gibdd/vehicle/hybrid-reg-actions/by-{request-type}/{car-id}

Поддерживаемые идентификаторы ({request-type})

Тип идентификатора Значение в URL Пример пути
VIN vin-number /by-vin-number/LA900S0012775
Номер кузова car-body-number /by-car-body-number/XWB3D31UD6A058612
Номер шасси chassis-number /by-chassis-number/LA900S0012775

Параметры ответа

Поле Тип Описание
id string Уникальный идентификатор запроса
cost int Стоимость запроса
method string Название метода (ownershipNew)
request object Переданные параметры
vin_number string VIN ТС (если был указан)
is_error bool Признак ошибки выполнения
is_completed bool Успешность выполнения
result[] array Массив с данными о ТС

Поля в result[].vehicle

Поле Тип Описание
vin string VIN ТС
model_car string Модель
body_number string Номер кузова
chassis_number string Номер шасси
year int Год выпуска
category string Категория
engine_volume int Объём двигателя
color string Цвет ТС
norm_color string Нормализованный цвет
engine_number string Номер двигателя
power_kwt float Мощность в кВт
power_hp int Мощность в л.с.
type string Код типа ТС
type_name string Наименование типа
vehicle_passport object Паспорт ТС

Поля в ownership_periods[]

Поле Тип Описание
period_start string Начало периода
period_end string Конец периода (может быть пустым)
person_type string Тип владельца (Физическое лицо / Юридическое лицо)
extended_person_type string Расширенный тип (может быть пустым)
last_operation string Код последней операции (если есть)
last_operation_name string Название последней операции (если есть)
Authorizations:
basicAuth
path Parameters
chassis_number
required
string
Example: RF11492141
Request Body schema: application/json
required
type
required
string

Источник данных: "online", "cache", "cache+online", "online+cache"

Responses

Request samples

Content type
application/json
{
  • "type": "cache+online"
}

Response samples

Content type
application/json
{
  • "response": {
    }
}

Регистрационные действия

Получение данных о регистрационных действиях транспортного средства по VIN-номеру или номеру кузова (фрейму): периоды владения, характеристики ТС, данные ПТС/СТС.

Источник данных: внешний источник

Общая информация

Параметр Значение
Base URL https://bad-api.bigautodata.ru
Авторизация Basic
Content-Type application/json

Флоу

  1. POST /api/v5/reg-actions — отправить запрос с VIN и/или номером кузова, получить результат

Примечания

  • VIN: ровно 17 символов, A-Z (без I/O/Q) + 0-9

  • Должно быть указано хотя бы одно из полей: vin_number или body_number

  • При наличии обоих полей поиск выполняется по vin_number

  • result: null при is_error: false — данных нет в источнике, это не ошибка

  • result: null при is_error: true — ошибка источника

По VIN

POST /api/v5/reg-actions

Запрос данных о регистрациях ТС по VIN-номеру. Ответ возвращается синхронно.

Параметры запроса (body)

Параметр Тип Обязателен Описание
vin_number string да* VIN-номер транспортного средства (17 символов)
body_number string да* Номер кузова (фрейм)

* Должно быть указано хотя бы одно из полей. При наличии обоих — поиск по vin_number.

Валидация VIN

Правило Описание
Длина Ровно 17 символов
Допустимые символы A-Z (латиница, без I/O/Q) + 0-9
Regex ^[A-HJ-NPR-Z0-9]{17}$
Пример NMTBZ28E90R147164

Параметры ответа (response)

Параметр Тип Описание
id string (uuid) Уникальный ID запроса
cost string / null Стоимость запроса
method string Название метода: "registrations"
request object Параметры исходного запроса
request.vin_number string VIN из запроса
is_error bool Флаг ошибки (true — ошибка, false — нет)
is_completed bool Готовность результата (true — завершено, false — в обработке)
result array / null Массив данных о регистрации ТС или null

Поля result[].vehicle (данные ТС)

Параметр Тип Описание
vin string / null VIN-номер
body_number string / null Номер кузова
reg_number string / null Государственный регистрационный номер
model_car string / null Марка и модель (например: "ТОЙОТА КОРОЛЛА")
year number / null Год выпуска
engine_volume number / null Объём двигателя в куб. см
color string / null Цвет ТС
power_hp number / null Мощность в л.с.
power_kwt number / null Мощность в кВт
max_weight number / null Разрешённая максимальная масса (кг)
weight_without_loading number / null Масса без нагрузки (кг)
category string / null Категория ТС (A, B, C, D)
last_reg_action string / null Последнее регистрационное действие
record_status string / null Статус записи ("действующая" / "прекращена")
sts.num string / null Серия и номер СТС
sts.date string / null Дата выдачи СТС (YYYY-MM-DD)
pts.num string / null Серия и номер ПТС
pts.date string / null Дата выдачи ПТС (YYYY-MM-DD)
---

Поля result[].ownership_periods[]

Параметр Тип Описание
person_type string Тип владельца: "Физическое лицо" / "Юридическое лицо"
period_start string / null Дата начала владения (YYYY-MM-DD)
period_end string / null Дата окончания (YYYY-MM-DD) или пустая строка — текущий владелец

Логика состояний

is_error is_completed cost result Что происходит
false true 0 [{...}] Данные найдены
false true 0 null Данных нет в источнике
true false null null Ошибка источника
Authorizations:
basicAuth
Request Body schema: application/json
required
vin_number
required
string

VIN транспортного средства

Responses

Request samples

Content type
application/json
{
  • "vin_number": "NMTBZ28E90R147164"
}

Response samples

Content type
application/json
Example
{
  • "response": {
    }
}

Регистрации, ограничения, угон

Регистрации, ограничения, угон (vehicle-records)

Проверка данных по VIN: атрибуты ТС, история владения, ограничения и сведения о розыске.

Общая информация

Параметр Значение
Base URL https://bad-api.bigautodata.ru
Авторизация Basic
Content-Type application/json

Флоу

  1. POST /api/v5/vehicle-records/task — создать задачу, получить task_id

  2. GET /api/v5/vehicle-records/task/{task_id} — polling с интервалом 1–5 сек, пока is_completed не станет true

Примечания

  • result: null при is_error: false и is_completed: true — данных по VIN у источника нет, это не ошибка

  • period_end: "" в ownership_periods[] означает текущего владельца («по настоящее время»)

  • restrictions: null — ограничений на ТС нет; in_search: false — ТС в розыске не значится

Регистрации, ограничения, угон (vehicle-records)

Проверка данных по VIN: атрибуты ТС, история владения, ограничения и сведения о розыске.

Общая информация

Параметр Значение
Base URL https://bad-api.bigautodata.ru
Авторизация Basic
Content-Type application/json

Флоу

  1. POST /api/v5/vehicle-records/task — создать задачу, получить task_id

  2. GET /api/v5/vehicle-records/task/{task_id} — polling с интервалом 1–5 сек, пока is_completed не станет true

Примечания

  • result: null при is_error: false и is_completed: true — данных по VIN у источника нет, это не ошибка

  • period_end: "" в ownership_periods[] означает текущего владельца («по настоящее время»)

  • restrictions: null — ограничений на ТС нет; in_search: false — ТС в розыске не значится

По VIN

POST /api/v5/vehicle-records/task

Создание задачи на получение данных по VIN. После получения task_id — polling через GET.

Параметры запроса (body)

Параметр Тип Обязателен Описание
vin_number string да VIN-номер ТС

Валидация

Поле Формат Regex Пример
vin_number Ровно 17 символов: A-Z (без I, O, Q) + 0-9, регистр не важен. Пробелы не допускаются ^[A-HJ-NPR-Z0-9]{17}$ (case-insensitive) XW8ZZZ61ZCG022545

Параметры ответа (успех)

Параметр Тип Описание
task_id string (UUID) ID задачи для polling через GET
id string (UUID) Уникальный идентификатор запроса

Параметры ответа (ошибка)

Параметр Тип Описание
message string Описание ошибки
id string (UUID) Уникальный идентификатор запроса

Коды ошибок

HTTP message Описание
400 invalid payload Невалидный VIN (не 17 символов / запрещённые символы / пробелы / не строка)
401 Missing authorization data Нет/невалидный токен авторизации
Authorizations:
basicAuth
Request Body schema: application/json
required
vin_number
required
string

VIN транспортного средства

Responses

Request samples

Content type
application/json
{
  • "vin_number": "XW8ZZZ61ZCG022545"
}

Response samples

Content type
application/json
{
  • "task_id": "eb0318bd-ce6a-400f-a9ad-adeb6d98ee1e",
  • "id": "a3f1b2c4-5d6e-7f8a-9b0c-1d2e3f4a5b6c"
}

Получить результат по task_id

GET /api/v5/vehicle-records/task/{task_id}

Получение результатов запроса. Клиент опрашивает этот эндпоинт, пока is_completed не станет true. Интервал polling 1–5 сек.

Параметры пути

Параметр Тип Обязателен Описание
task_id string (UUID) да UUID задачи из POST

Параметры ответа (response)

Параметр Тип Описание
id string (UUID) Уникальный идентификатор запроса
method string Название метода ("vehicle-records")
cost integer / null Стоимость запроса. 0 при готовом ответе, null пока задача не завершена или при ошибке
request object / null Эхо исходного запроса. null при ошибках валидации
is_error bool true — ошибка
is_completed bool true — задача завершена, false — в обработке
result array / null Массив с данными ТС или ошибкой; null если данных у источника нет либо задача ещё в обработке

Поля result[].vehicle (атрибуты ТС)

Параметр Тип Описание
vin string VIN-номер из запроса
model_car string Марка и модель одной строкой («ФОЛЬКСВАГЕН ПОЛО»)
year integer Год выпуска
category string Категория ТС (A, B, C, D)
engine_volume integer Объём двигателя, куб. см
color string Цвет ТС из источника (UPPERCASE)
norm_color string Цвет в Title Case (нормализация на стороне сервиса)
power_kwt number Мощность, кВт
power_hp number Мощность, л.с.
eco_class integer / null Экологический класс
mass string Масса без нагрузки, кг. "" если данных нет
mass_max string Разрешённая максимальная масса, кг. "" если данных нет
Параметр Тип Описание
restrictions array / null Массив ограничений на ТС. null если ограничений нет. См. поля ниже
in_search boolean true — ТС в розыске, false — нет

Поля result[].restrictions[] (ограничения)

Параметр Тип Описание
document_agency string Орган, выдавший основание (суд, ФССП и т.п.)
enforcement_proceedings_issue_date string (YYYY-MM-DD) Дата возбуждения исполнительного производства
enforcement_proceedings_number string Номер исполнительного производства
initiate_region string Регион возбуждения ИП
main_reason string Основание: реквизиты документа, ФИО должника, СПИ, ИП
osp_address string Адрес отдела судебных приставов (ОСП)
restriction_type string Тип ограничения (например, «Запрет на регистрационные действия»)
status string Статус записи из источника (например, "1")

Поля result[].ownership_periods[] (история владения)

Параметр Тип Описание
period_start string (YYYY-MM-DD) Дата начала владения
period_end string (YYYY-MM-DD) / "" Дата окончания. "" — текущий владелец («по настоящее время»)
person_type string Enum: Natural (физлицо), Legal (юрлицо)
extended_person_type string Тип владельца текстом: «Физическое лицо» / «Юридическое лицо»
last_operation_name string Название регистрационного действия

Логика состояний

is_completed is_error result Что происходит
false false null Задача выполняется, продолжайте polling
true false [{vehicle, restrictions, in_search, ownership_periods}] Данные найдены
true false null У источника нет данных по VIN
true true [{ error_code: 1, message }] Ошибка внешнего источника
false true [{ error_code: 2, message }] Невалидный task_id (HTTP 400)

Коды ошибок

error_code HTTP message Описание
1 200 Внешний источник временно недоступен Ошибка внешнего источника, таймаут или сетевая ошибка
2 400 invalid task id Задача не найдена или невалидный task_id
3 500 Внутренняя ошибка сервера Внутренняя ошибка сервиса
Authorizations:
basicAuth
path Parameters
task_id
required
string

Responses

Response samples

Content type
application/json
Example
{
  • "response": {
    }
}

ЭПТС

Коллекция для проекта ЭПТС.

Включает клиентскую и микросервисную ручки для получения данных ЕПТС по VIN.

ЭПТС

Описание: возвращает данные ЕПТС по VIN.

Наименование: epts
Метод: GET

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

Параметр Тип Обязателен Описание
vin string да VIN транспортного средства

Параметры ответа

Поле Тип Описание
response object Контейнер с ответом
id string Идентификатор запроса
cost number/null Стоимость запроса
method string Название метода: epts
request object Эхо-запрос
request.vin string VIN транспортного средства
is_error bool false — ошибок нет; true — ошибка
is_completed bool false — ошибка; true — ошибок нет
message string Текст ошибки/сообщения (если есть)
result[] array Массив данных ЭПТС (0 или 1 элемент)

Поля в result[]

Параметр Тип Описание
type string Тип ЭПТС
status string Статус ЭПТС
payment_recycling_fee string Информация об уплате утилизационного сбора
customs_document_id string/null Идентификатор таможенного документа
customs_restrictions string/null Таможенные ограничения
other_restrictions array Иные ограничения
last_registration_action string Последнее регистрационное действие
ownership_roles array Роли участников владения
ownership_roles[].role_code string Код роли
ownership_roles[].role_name string Наименование роли
manufacturer_info object/null Данные производителя
Authorizations:
basicAuth
path Parameters
vin_number
required
string
Example: LGWEF4A51RF710533

Responses

Response samples

Content type
application/json
Example
{
  • "response": {
    }
}

Отзывные кампании

Отзывные кампании

Сведения об отзывных кампаниях, в которых участвует транспортное средство. На вход — VIN, на выходе — список кампаний: организация-инициатор отзыва, марка, перечень моделей, причина отзыва, рекомендованные действия, ссылка на публикацию, дата и адрес сервисного центра.

Общая информация

Параметр Значение
Base URL https://bad-api.bigautodata.ru
Авторизация заголовок Authorization: Basic {{TOKEN}}
Content-Type application/json
Тип синхронный — POST сразу возвращает результат

Формат ответа

Единый конверт response: id, cost, method, is_error, is_completed, request (эхо параметров), result[]. В result[] лежат отзывные кампании; при ошибке — объект error_code + message.

Коды ошибок

error_code HTTP Значение retry
1 500 Внутренняя ошибка false
2 400 Ошибка валидации (request: null) false

Ручки

Ручка Эндпоинт
Отзывные кампании по VIN POST /api/v6/vehicle/recall-campaigns

Отзывные кампании по VIN — POST /api/v6/vehicle/recall-campaigns

Отзывные кампании по VIN

Описание

Метод возвращает сведения об отзывных кампаниях, в которых участвует транспортное средство. На вход принимается VIN в теле запроса, на выходе — список кампаний по этому VIN: организация-инициатор отзыва, марка, перечень моделей, причина отзыва, рекомендованные действия, ссылка на публикацию, дата публикации и адрес сервисного центра.

Метод синхронный: ответ приходит сразу. Отсутствие кампаний по VIN — валидный результат, а не ошибка.

Общая информация

Параметр Значение
Метод POST
Endpoint /api/v6/vehicle/recall-campaigns
Наименование в ответе vehicle_recall_campaigns

Авторизация

В заголовке Authorization: Basic {{TOKEN}}.

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

Передаются в теле запроса в формате JSON.

Параметр Тип Обязателен Описание
vin string да VIN транспортного средства, 17 символов

Envelope ответа

Параметр Тип Описание
response.id string Идентификатор запроса
response.cost number Стоимость запроса
response.method string vehicle_recall_campaigns
response.request object | null Эхо параметров запроса; null при ошибке валидации
response.is_error bool Флаг ошибки
response.is_completed bool Запрос обработан
response.result array Отзывные кампании по VIN; [], если кампаний нет; при ошибке — [{ error_code, message }]

Конверт есть не у всех ответов. При 401 приходит плоский объект с единственным полем message, без response и без result:

{
  "message": "Missing authorization data"
}

Клиент, который читает response.result без проверки, на этом ответе упадёт.

Поля в result[]

Параметр Тип Описание
organization string Организация-инициатор отзыва (импортёр, дистрибьютор)
brand string Марка транспортного средства
models array Модели и типы кузова, попадающие под кампанию
models[].name string Название модели с типом кузова, например C-Class (тип 205)
recall_reason string Описание технической проблемы, ставшей причиной отзыва
recommended_actions string Рекомендованные действия по устранению проблемы
source_url string | null Ссылка на публикацию об отзывной кампании
publication_date string | null Дата публикации в формате YYYY-MM-DD
service_center_address string | null Адрес сервисного центра, где проводятся работы по кампании

Особенности данных

  • По одному VIN может вернуться несколько кампаний — они лежат в result[] подряд.
  • Поля publication_date и service_center_address заполнены не у всех кампаний; при отсутствии значения приходит null.
  • Тексты recall_reason и recommended_actions — длинные неструктурированные строки, на составляющие не разбираются.
  • Буквы I, O, Q в переданном VIN приводятся к 1, 0, 0.
  • Символы вне [A-Z0-9] в VIN игнорируются, поэтому VIN с посторонними знаками может не пройти проверку длины.

Состояния ответа

Состояние HTTP Смысл
result с кампаниями 200 Кампании найдены
result: [], is_error: false, is_completed: true 200 ТС в кампаниях не участвует
result: [{ error_code: 2, message }], request: null 400 Ошибка валидации
result: [{ error_code: 1, message }] 500 Внутренняя ошибка
{ "message": "Missing authorization data" }, конверта response нет 401 Не передан или недействителен Authorization

Коды ошибок (error_code)

error_code Описание retry
1 Внутренняя ошибка сервиса false
2 Ошибка валидации входных данных false

Сообщения валидации

Условие message
vin не передан vin is required
Длина vin не равна 17 символам vin must be 17 characters

Пример запроса

curl -X POST 'https://bad-api.bigautodata.ru/api/v6/vehicle/recall-campaigns' \
  --header 'Authorization: Basic {{TOKEN}}' \
  --header 'Content-Type: application/json' \
  --data '{ "vin": "WDC1569431J310875" }'
Authorizations:
basicAuth
Request Body schema: application/json
required
vin
required
string

VIN транспортного средства

Responses

Request samples

Content type
application/json
{
  • "vin": "WDC1569431J310875"
}

Response samples

Content type
application/json
Example
{
  • "response": {
    }
}

ОСАГО

BAD: ОСАГО — это B2B API-сервис, который по VIN, госномеру, номеру шасси, номеру кузова или номеру полиса ОСАГО возвращает:

  • Краткий перечень технических характеристик автомобиля

  • Краткую или развернутую информацию о полисе ОСАГО из открытых и партнёрских источников

Принцип работы

  1. Вы отправляете запрос на предоставление информации о полисе ОСАГО:

  • VIN-номеру

  • госномеру

  • номеру шасси

  • номеру кузова

  • номеру ОСАГО

2. Сервис собирает данные из официальных источников (в базе более 65 млн. ТС)

3. Формируется структурированный JSON-отчёт

Что вы получаете

В зависимости от запроса, отчет может содержать:

  • данные о полисе ОСАГО по номеру полиса (страховая, идентификаторы ТС, статус полиса, дата создания, даты действия полиса, марка и модель ТС, данные страхователя)

  • краткие данные о последнем полисе ОСАГО с датами действия по идентификаторам ТС (страховая, идентификаторы ТС, дата создания, дата начала и окончания действия полиса, номер и серия полиса, статус)

  • базовые данные о последнем полисе ОСАГО по идентификаторам ТС (КБМ, идентификаторы ТС, страховая, мощность двигателя, флаги о прицепе/транзите, данные страхователя, ограничения, марка и модель ТС, регион, серия и статус, период действия полиса)

  • развернутые данные о последнем полисе ОСАГО с датами действия по идентификаторам ТС (КБМ, идентификаторы ТС, дата создания и окончания действия полиса, страховая, мощность двигателя, флаги о прицепе/транзите, данные страхователя, ограничения, марка и модель ТС, регион, серия и статус, период действия полиса)

Авторизация

Стандартная авторизация в bad-admin-app (Basic Auth)

Используемые компоненты:

  • База данных bad-admin-app (учетные записи пользователей)

  • Механизм Basic Authentication

Список возможных ошибок

  1. Запрос не отработал за выбранное время, необходимо отправить запрос повторно

  • Код: 200 OK

  • "is_error": false, "is_completed": false

  • "result": []

2. Запрос завершился ошибкой, необходимо отправить запрос повторно

  • Код: 200 OK

  • "is_error": true, "is_completed": true

  • "result": []

ОСАГО по номеру полиса

Общая информация

Описание: возвращает список данных о полисе ОСАГО по номеру полиса.

Описание

Наименование: policy_by_number

Метод: GET

Версия: V5

Полный путь метода: https://bad-api.bigautodata.ru/api/v5/policy-info/policy/{policy-number}

Параметры метода:

Параметр Тип Обязательный Описание
policy-number string да номер серия полиса в формате ХХХ0209604087

Пример использования

curl --location 'https://bad-api.bigautodata.ru/api/v5/policy-info/policy/ХХХ0209604087' \
--header 'accept: application/json' \
--header 'authorization: Basic <ТОКЕН>'

Параметры метода:

Параметр Тип Обязательный Описание
policy-number string да номер серия полиса в формате ХХХ0209604087

Параметры ответа:

Свойство Тип Описание
id string Идентификатор запроса
cost string стоимость запроса (может быть null)
method string Используемый сервис
request object Контейнер для параметров, полученных в запросе
policy_number string Серия и номер полиса (формат ХХХ0209604087)
is_error bool Возможные значения:

- false - ошибок нет

- true - ошибка. Если внутренняя ошибка
или ошибка источника 4ХХ
или 5ХХ ошибка, кроме
таймаута
is_completed bool Возможные значения:

- false - ошибка. Если внутренняя ошибка
или ошибка источника 4ХХ
или 5ХХ ошибка, кроме
таймаута

- true - ошибок нет
result object Контейнер, содержащий данные о полисе
policy_serial string Серия полиса
policy_number string Номер полиса
insurer_name string Наименование страховой компании
license_plate string ГРЗ транспортного средства
vin string VIN транспортного средства
body_number string Номер кузова транспортного средства
chassis_number string Номер шасси транспортного средства
policy_id string ID полиса
policy_state string Текущее состояние полиса
date_create string Дата создания договора (формат ГГГГ-ММ-ДД)
date_agreement_create string Дата создания доп. соглашения (формат ГГГГ-ММ-ДД)
date_action_beg string Дата начала действия полиса (формат ГГГГ-ММ-ДД)
date_action_end string Дата завершения действия полиса (формат ГГГГ-ММ-ДД)
period1_beg string Начало периода 1
period1_end string Конец периода 1
period2_beg string Начало периода 2
period2_end string Конец периода 2
period3_beg string Начало периода 3
period3_end string Конец периода 3
mark_car string Марка транспортного средства
model_car string Модель транспортного средства
insurer string Страхователь
usage_period string Период использования на запрашиваемую дату:

- активен

- не активен
car_model string Марка и модель транспортного средства
category string Категория
power_hp float Мощность двигателя
in_transit bool Признак нахождения в транзите.

Возможные значения:

- false - нет

- true - да
has_trailer bool Признак наличия прицепа.

Возможные значения:

- false - нет

- true - да
usage_target string Цель использования
limitations string Лимиты
limitations_count string Количество лимитов
owner string Владелец транспортного средства
kbm float КБМ
region string Регион
norm_region string Нормализованное значение региона
region_number string Номер региона
premium float Стоимость
osago_status string Статус полиса.

Возможные значения:

- Действует

- Не действует
max_mass string Максимальная масса
seats_count int Количество сидений
Authorizations:
basicAuth
path Parameters
policy
required
string
Example: 0548432037

Responses

Response samples

Content type
application/json
{
  • "response": {
    }
}

даты действия полиса ОСАГО

Общая информация

Описание: возвращает краткий список данных о полисе ОСАГО

Описание

Наименование: policy_info_short

Метод: POST

Версия: V5

Полный путь метода: https://bad-api.bigautodata.ru/api/v5/policy-info/vehicle/short/by-{request-type}/{car-id}

Параметры метода:

Параметр Тип Обязательный Описание
request-type string да Тип идентификатора ТС
car-id string да Значение идентификатора

Варианты request_type:

request-type Описание
number-plate ГРЗ
vin-number VIN транспортного средства
car-body-number по номеру кузова
chassis-number по номеру шасси

Примеры использования:

curl --location --request POST 'https://bad-api.bigautodata.ru/api/v5/policy-info/vehicle/short/by-vin-number/XWB3D31UD6A058612' \
--header 'authorization: Basic <ТОКЕН>' \
--header 'Content-Type: application/json'

Параметры ответа:

Свойство Тип Описание
response object Контейнер с ответом
id string Идентификатор запроса
cost string стоимость запроса (может быть null)
method string Используемый сервис
request object Контейнер для параметров, полученных в запросе
vin_number string VIN транспортного средства
is_error bool Возможные значения:

- false - ошибок нет

- true - ошибка. Если внутренняя ошибка
или ошибка источника 4ХХ
или 5ХХ ошибка, кроме
таймаута
is_completed bool Возможные значения:

- false - ошибка. Если внутренняя ошибка
или ошибка источника 4ХХ
или 5ХХ ошибка, кроме
таймаута

- true - ошибок нет
result object Контейнер, содержащий информацию по полису
series string Серия полиса
number string Номер полиса
company string Страховая компания
status string Статус полиса.

Возможные значения:

- Действует

- Не действует
start_date string Начало действия полиса (формат ГГГГ-ММ-ДД)
end_date string Дата завершения полиса (формат ГГГГ-ММ-ДД)
date_created string Дата создания договора (формат ГГГГ-ММ-ДД)
vin_number string VIN-номер
body_number string Номер кузова транспортного средства
chassis_number string Номер шасси транспортного средства
license_plate string ГРЗ
Authorizations:
basicAuth
path Parameters
number_plate
required
string
Example: У460ТР25

Responses

Response samples

Content type
application/json
Example
{
  • "response": {
    }
}

полис ОСАГО (без дат)

Общая информация

Описание: возвращает развернутый список данных полиса ОСАГО без дат.

Описание

Наименование: policy_info

Метод: POST

Версия: V5

Полный путь метода: https://bad-api.bigautodata.ru/api/v5/policy-info/vehicle/general/by-{request-type}/{car-id}

Параметры метода:

Параметр Тип Обязательный Описание
request-type string да Тип идентификатора ТС
car-id string да Значение идентификатора

Варианты request_type:

request-type Описание
number-plate ГРЗ
vin-number VIN транспортного средства
car-body-number по номеру кузова
chassis-number по номеру шасси

Пример использования

curl --location --request POST 'https://bad-api.bigautodata.ru/api/v5/policy-info/vehicle/general/by-vin-number/XWB3D31UD6A058612' \
--header 'authorization: Basic <ТОКЕН>' \
--header 'Content-Type: application/json'

Параметры ответа:

Свойство Тип Описание
response object Контейнер с ответом
id string Идентификатор запроса
cost string стоимость запроса (может быть null)
method string Используемый сервис
request object Контейнер для параметров, полученных в запросе
vin_number string VIN транспортного средства
is_error bool Возможные значения:

- false - ошибок нет

- true - ошибка. Если внутренняя ошибка
или ошибка источника 4ХХ
или 5ХХ ошибка, кроме
таймаута
is_completed bool Возможные значения:

- false - ошибка. Если внутренняя ошибка
или ошибка источника 4ХХ
или 5ХХ ошибка, кроме
таймаута

- true - ошибок нет
result object Контейнер, содержащий информацию по полису
KBM int КБМ
body_number string Номер кузова
category string Категория
chassis_number string Номер шасси
company string Страховая компания
engine_power float Мощность двигателя
has_trailer bool Признак наличия прицепа.

Возможные значения:

- false - нет

- true -  да
in_transit bool Признак нахождения в транзите.

Возможные значения:

- false - нет

- true -  да
insurer string Страхователь
insurer_birthday string ДР страхователя
insurer_name string ФИО страхователя
license_plate string ГРЗ
limitations string Лимиты
limitations_count int Количество лимитов
mark string Марка транспортного средства
mark_model string Марка и модель транспортного средства
model string Модель транспортного средства
norm_region string Нормализованное значение региона
number string Номер полиса
owner string Владелец транспортного средства
owner_birthday string ДР владельца
owner_name string ФИО владельца
price float Стоимость
region string Регион
region_number string Номер региона
series string Серия полиса
status string Статус полиса.

Возможные значения:

- Действует

- Не действует
usage_period string Период использования
usage_target string Цель использования
vin_number string VIN-номер
Authorizations:
basicAuth
path Parameters
vin_number
required
string
Example: XWB3D31UD6A058612

Responses

Response samples

Content type
application/json
{
  • "response": {
    }
}

полис ОСАГО с датами

Общая информация

Описание: возвращает развернутый список данных о полисе ОСАГО с датами действия.

Описание

Наименование: policy_info_short

Метод: POST

Версия: V5

Полный путь метода: https://bad-api.bigautodata.ru/api/v5/policy-info/vehicle/full/by-{request-type}/{car-id}

Параметры метода:

Параметр Тип Обязательный Описание
request-type string да Тип идентификатора ТС
car-id string да Значение идентификатора

Варианты request_type:

request-type Описание
number-plate ГРЗ
vin-number VIN транспортного средства
car-body-number по номеру кузова
chassis-number по номеру шасси

Примеры использования:

curl --location --request POST 'https://bad-api.bigautodata.ru/api/v5/policy-info/vehicle/full/by-vin-number/XWB3D31UD6A058612' \
--header 'authorization: Basic <ТОКЕН>' \
--header 'Content-Type: application/json'

Параметры ответа:

Свойство Тип Описание
response object Контейнер с ответом
id string Идентификатор запроса
cost string стоимость запроса (может быть null)
method string Используемый сервис
request object Контейнер для параметров, полученных в запросе
vin_number string VIN транспортного средства
is_error bool Возможные значения:

- false - ошибок нет

- true - ошибка. Если внутренняя ошибка
или ошибка источника 4ХХ
или 5ХХ ошибка, кроме
таймаута
is_completed bool Возможные значения:

- false - ошибка. Если внутренняя ошибка
или ошибка источника 4ХХ
или 5ХХ ошибка, кроме
таймаута

- true - ошибок нет
result object Контейнер, содержащий информацию по полису
KBM int КБМ
body_number string Номер кузова транспортного средства
category string Категория
chassis_number string Номер шасси транспортного средства
company string Страховая компания
date_created string Дата создания договора (формат ГГГГ-ММ-ДД)
end_date string Дата завершения договора (формат ГГГГ-ММ-ДД)
engine_power float Мощность двигателя
has_trailer bool Признак наличия прицепа.

Возможные значения:

- false - нет

- true - да
in_transit bool Признак нахождения в транзите.

Возможные значения:

- false - нет

- true - да
insurer string Страхователь
insurer_birthday string ДР страхователя
insurer_name string ФИО страхователя
license_plate string ГРЗ
limitations string Лимиты
limitations_count int Количество лимитов
mark string Марка транспортного средства
mark_model string Марка и модель транспортного средства
model string Модель транспортного средства
norm_region string Нормализованное значение региона
number string Номер полиса
owner string Владелец транспортного средства
owner_birthday string ДР владельца
owner_name string ФИО владельца
price float Стоимость
region string Регион
region_number string Номер региона
series string Серия полиса
start_date string Начало действия полиса
status string Статус полиса.

Возможные значения:

- Действует

- Не действует
usage_period string Период использования
usage_target string Цель использования
vin_number string VIN-номер
Authorizations:
basicAuth
path Parameters
number_plate
required
string
Example: Х468РЕ102

Responses

Response samples

Content type
application/json
{
  • "response": {
    }
}

РСА Европротокол

Европротокол

Метод позволяет получить информацию о ДТП, оформленных через мобильное приложение «Европротокол».

Доступен поиск по VIN, ГРЗ, номеру кузова или номеру шасси.

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

Параметр Тип Описание
request_type string Тип идентификатора ТС.
Возможные значения:
• vin_number — VIN транспортного средства
• number_plate — ГРЗ
• car_body_number — номер кузова
• chassis_number — номер шасси
car_id string Значение переданного идентификатора ТС (например, VIN)

Параметры ответа

Параметр Тип Описание
id string Идентификатор запроса
cost string / null Стоимость запроса
method string Используемый сервис (europrotocols)
request object Параметры, переданные в запросе
request.vin_number string VIN транспортного средства
is_error bool false — ошибок нет
true — ошибка выполнения
is_completed bool true — запрос выполнен успешно
false — ошибка выполнения
result array Контейнер с данными о страховых случаях

result

Поле Тип Описание
requestHash string Идентификатор страхового случая
insurerName string Наименование страховой компании
lossDateTime string Дата ДТП
fullPolicy string Серия и номер страхового полиса
Authorizations:
basicAuth
path Parameters
request_type
required
string
car_id
required
string

Responses

Response samples

Content type
application/json
{
  • "response": {
    }
}

Штрафы по документам

Штрафы по документам (fines)

Обновление: В ответ добавлен объект payment_details с платёжными реквизитами для оплаты штрафа. Реквизиты доступны только для штрафов ГИБДД (УИН начинается на 188 + АМПП, МАДИ) при поиске по СТС. В остальных случаях payment_details: null.

Проверка штрафов по номеру СТС, водительскому удостоверению или УИН постановления. Типы штрафов: ГИБДД (камеры), АМПП, МАДИ, платные дороги.

Общая информация

Параметр Значение
Base URL https://bad-api.bigautodata.ru
Авторизация Basic
Content-Type application/json

Флоу

  1. POST /api/v5/fines/task — создать задачу, получить task_id

  2. GET /api/v5/fines/task?task_id={task_id} — polling с интервалом 3-5 сек, пока is_completed не станет true

Примечания

  • Суммы штрафов (amount, original_amount) всегда в копейках. Для рублей делите на 100

  • result: [] при is_error: false — штрафов нет, это не ошибка

Штрафы по документам (fines)

Обновление: В ответ добавлен объект payment_details с платёжными реквизитами для оплаты штрафа. Реквизиты доступны только для штрафов ГИБДД (УИН начинается на 188 + АМПП, МАДИ) при поиске по СТС. В остальных случаях payment_details: null.

Проверка штрафов по номеру СТС, водительскому удостоверению или УИН постановления. Типы штрафов: ГИБДД (камеры), АМПП, МАДИ, платные дороги.

Общая информация

Параметр Значение
Base URL https://bad-api.bigautodata.ru
Авторизация Basic
Content-Type application/json

Флоу

  1. POST /api/v5/fines/task — создать задачу, получить task_id

  2. GET /api/v5/fines/task?task_id={task_id} — polling с интервалом 3-5 сек, пока is_completed не станет true

Примечания

  • Суммы штрафов (amount, original_amount) всегда в копейках. Для рублей делите на 100

  • result: [] при is_error: false — штрафов нет, это не ошибка

По СТС

POST /api/v5/fines/task

Создание задачи на поиск штрафов. После получения task_id — polling через GET.

Параметры запроса (body)

Параметр Тип Обязателен Описание
document_type string да Тип документа: sts, driver_license, bill_uin
document_number string да Номер документа
number_plate string условно Госномер автомобиля. Обязателен при document_type: "sts"

Валидация

Все значения должны быть строкой. Пробелы не допускаются.

Поле Формат Regex Пример
sts 2 цифры + 2 символа (кириллица/латиница/цифра) + 6 цифр ^(\d{2})([А-ЯЁа-яёA-Za-z0-9]{2})(\d{6})$ 12АБ123456
driver_license 4 символа (цифры или кириллица) + 6 цифр ^([0-9А-ЯЁа-яё]{4})(\d{6})$ АБ12567890
bill_uin 20 или 25 цифр + валидация контрольной суммы `^(\d{20} \d{25})$`
number_plate 1 буква + 3 цифры + 2 буквы + регион (2-3 цифры) ^[АВЕКМНОРСТУХ]\d{3}[АВЕКМНОРСТУХ]{2}\d{2,3}$ А417ЕР977

Параметры ответа (успех)

Параметр Тип Описание
task_id string ID задачи для polling через GET
id string Уникальный идентификатор запроса

Параметры ответа (ошибка)

Параметр Тип Описание
message string Описание ошибки
id string Уникальный идентификатор запроса

Коды ошибок валидации

HTTP message Описание
400 document_type must be in: [sts driver_license bill_uin] Невалидный тип документа
400 sts must be 2 digits + 2 letters/digits + 6 digits Неверный формат СТС
400 driver_license must be 4 chars (digits or cyrillic) + 6 digits Неверный формат ВУ
400 bill_uin must be 20 or 25 digits Неверный формат УИН
400 incorrect bill uin format УИН не прошёл валидацию контрольной суммы
400 invalid number_plate format Неверный формат госномера
400 invalid payload format Передано число вместо строки
Authorizations:
basicAuth
Request Body schema: application/json
required
document_type
required
string

Только sts

document_number
required
string

Номер СТС (без пробелов)

Responses

Request samples

Content type
application/json
{
  • "document_type": "driver_license",
  • "document_number": "9919291472"
}

Response samples

Content type
application/json
{
  • "task_id": "1954624654",
  • "id": "a3f1b2c4-5d6e-7f8a-9b0c-1d2e3f4a5b6c"
}

Получить результат по task_id

GET /api/v5/fines/task

Получение результатов задачи. Polling с интервалом 3-5 сек, пока is_completed не станет true.

Параметры запроса (query)

Параметр Тип Обязателен Описание
task_id string да ID задачи (task_id из ответа POST)

Параметры ответа (response)

Параметр Тип Описание
id string Уникальный идентификатор запроса
cost string / null Стоимость запроса
method string Название метода ("fines")
request object / null Параметры исходного запроса. null при ошибках
is_error bool Флаг ошибки (true — ошибка, false — нет)
is_completed bool Готовность результата (true — завершено, false — в обработке)
result array Массив штрафов или ошибка

Поля штрафа в result

Параметр Тип Описание
id string (UUID) Внутренний ID записи штрафа
number string Номер постановления (УИН)
description string Текстовое описание штрафа
amount integer Сумма штрафа в копейках (с учётом скидки)
original_amount integer / null Оригинальная сумма до скидки в копейках
is_paid boolean Оплачен ли штраф
issued_at string (ISO 8601) Дата и время выписки штрафа
discount_deadline string (YYYY-MM-DD) / null Дата окончания скидки
discount_percent integer / null Размер скидки в процентах
supplier string Наименование получателя платежа
fetched_at string (ISO 8601) Когда данные были получены от источника
expires_at string / null Срок актуальности данных
payment_details object / null Платёжные реквизиты для оплаты штрафа (см. ниже)
is_annulled boolean Начисление аннулировано ведомством. По умолчанию false
is_deleted boolean Начисление оплачено или удалено. По умолчанию false

Важно: если is_annulled: true или is_deleted: true, гарантированно заполнено только поле number. Остальные поля, включая id, могут быть null. Такие ситуации возможны только при поиске по bill_uin.

Поля payment_details

Реквизиты доступны только для штрафов ГИБДД (УИН начинается на 188) при поиске по СТС. В остальных случаях payment_details: null.

Параметр Тип Описание
ogrn string ОГРН получателя
bank string Наименование банка получателя
bik string БИК банка
inn string ИНН получателя
kpp string КПП получателя
rs string Расчётный счёт
corr string Корреспондентский счёт
recipient string Наименование получателя платежа
pay_purpose string Назначение платежа
oktmo string Код ОКТМО
kbk string Код бюджетной классификации

Логика состояний

is_completed is_error result Что происходит
false false [] Задача выполняется, продолжайте polling
true false [{штраф}, ...] Штрафы найдены
true false [] Штрафов нет
true false [{штраф, is_annulled: true}] Начисление аннулировано ведомством
true false [{штраф, is_deleted: true}] Начисление оплачено или удалено
true true [{ error_code, message }] Ошибка источника

Коды ошибок

error_code — числовой код ошибки. Коды находятся в разработке и могут измениться.

error_code HTTP message Описание
1 503 Внешний источник временно недоступен Любые ошибки внешнего источника. Возможно появление доп. ошибок
2 200 Некорректный task id Задача не найдена или невалидный ID
3 500 Внутренняя ошибка сервера Внутренняя ошибка сервера
Authorizations:
basicAuth
query Parameters
task_id
required
string
Example: task_id={{task_id}}

Responses

Response samples

Content type
application/json
Example
{
  • "response": {
    }
}

Штрафы по СТС

Описание:

Можно получить информацию по штрафам по следующим идентификаторам ТС:

Авторизация

Стандартная авторизация в bad-admin-app (Basic Auth)

Используемые компоненты:

  • База данных bad-admin-app (учетные записи пользователей)

  • Механизм Basic Authentication

Описание

Наименование: fines

Метод: POST

Версия: V5

Полный путь метода: https://bad-api.bigautodata.ru/api/v5/fines/by-{request-type}/{car-id}

Параметры метода:

Параметр Тип Обязательный Описание
request-type string да Тип идентификатора ТС
car-id string да Значение идентификатора

Варианты request_type:

request_type описание
sts номер СТС
vy водительское удостоверение
grz ГРЗ

Запрос отчета по СТС

Примеры использования

Поиск по СТС:

curl --location --request POST 'https://bad-api.bigautodata.ru/api/v5/fines/by-sts/9942839194' \
--header 'Authorization: Basic <ТОКЕН>' \
--header 'content-type: application/json'
Authorizations:
basicAuth
path Parameters
sts
required
string
Example: 7754518394

Responses

Response samples

Content type
application/json
{
  • "response": {
    }
}

Штрафы ФССП

Штрафы ФССП (fines-fssp)

Проверка задолженностей ФССП (судебная задолженность) по номеру СТС.

Общая информация

Параметр Значение
Base URL https://bad-api.bigautodata.ru
Авторизация Basic
Content-Type application/json

Флоу

  1. POST /api/v5/fines-fssp/task — создать задачу, получить task_id

  2. GET /api/v5/fines/task?task_id={task_id} — polling с интервалом 3-5 сек, пока is_completed не станет true

Штрафы ФССП (fines-fssp)

Проверка задолженностей ФССП (судебная задолженность) по номеру СТС.

Общая информация

Параметр Значение
Base URL https://bad-api.bigautodata.ru
Авторизация Basic
Content-Type application/json

Флоу

  1. POST /api/v5/fines-fssp/task — создать задачу, получить task_id

  2. GET /api/v5/fines/task?task_id={task_id} — polling с интервалом 3-5 сек, пока is_completed не станет true

По СТС

POST /api/v5/fines-fssp/task

Создание задачи на поиск задолженностей ФССП. После получения task_id — polling через GET.

Параметры запроса (body)

Параметр Тип Обязателен Описание
document_type string да Только sts
document_number string да Номер СТС (без пробелов)

Поле number_plate не передаётся — не участвует в поиске ФССП.

Валидация

Все значения должны быть строкой. Пробелы не допускаются.

Поле Формат Regex Пример
sts 2 цифры + 2 символа (кириллица/латиница/цифра) + 6 цифр ^(\d{2})([А-ЯЁа-яёA-Za-z0-9]{2})(\d{6})$ 9940371727

Параметры ответа (успех)

Параметр Тип Описание
task_id string ID задачи для polling через GET
id string Уникальный идентификатор запроса

Параметры ответа (ошибка)

Параметр Тип Описание
message string Описание ошибки
id string Уникальный идентификатор запроса

Коды ошибок валидации

HTTP message Описание
400 document_type must be in: [sts] Невалидный тип документа
400 sts must be 2 digits + 2 letters/digits + 6 digits Неверный формат СТС
400 invalid payload format Передано число вместо строки
Authorizations:
basicAuth
Request Body schema: application/json
required
document_type
required
string

Только sts

document_number
required
string

Номер СТС (без пробелов)

Responses

Request samples

Content type
application/json
{
  • "document_type": "sts",
  • "document_number": "9940371727"
}

Response samples

Content type
application/json
{
  • "task_id": "1954624654",
  • "id": "a3f1b2c4-5d6e-7f8a-9b0c-1d2e3f4a5b6c"
}

Получить результат по task_id

GET api/v5/fines-fssp/task?task_id

Polling с интервалом 3-5 сек, пока is_completed не станет true.

Параметры запроса (query)

Параметр Тип Обязателен Описание
task_id string да ID задачи (task_id из ответа POST)

Параметры ответа (response)

Параметр Тип Описание
id string Уникальный идентификатор запроса
cost string / null Стоимость запроса
method string Название метода ("fetch-fines-fssp-task")
request object / null Параметры исходного запроса. null при ошибках
is_error bool Флаг ошибки (true — ошибка, false — нет)
is_completed bool Готовность результата (true — завершено, false — в обработке)
expires_at string / null Срок актуальности данных
result array Массив задолженностей или ошибка

Поля request

Параметр Тип Описание
sts_number string Номер СТС

Поля задолженности в result

Структура bill совпадает со Штрафами по документам. Поля скидок и payment_details для ФССП всегда null.

Параметр Тип Описание
id string (UUID) Внутренний ID записи
number string Номер начисления (УИН)
description string Текстовое описание задолженности
amount integer Сумма в копейках
original_amount integer / null Всегда null для ФССП
is_paid boolean Оплачена ли задолженность
issued_at string (ISO 8601) Дата начисления
discount_deadline string / null Всегда null для ФССП
discount_percent integer / null Всегда null для ФССП
supplier string Наименование получателя платежа
fetched_at string (ISO 8601) Когда данные были получены от источника
expires_at string / null Срок актуальности данных
payment_details object / null Всегда null для ФССП

Логика состояний

is_completed is_error result Что происходит
false false [] Задача выполняется, продолжайте polling
true false [{задолженность}, ...] Задолженности найдены
true false [] Задолженностей нет
true true [{ error_code, message }] Ошибка

Коды ошибок

error_code HTTP message Описание
1 503 Внешний источник временно недоступен Ошибка внешнего источника
2 400 Некорректный task id Задача не найдена или невалидный ID
3 500 Внутренняя ошибка сервера Внутренняя ошибка
Authorizations:
basicAuth
query Parameters
task_id
required
string
Example: task_id={{task_id}}

Responses

Response samples

Content type
application/json
Example
{
  • "response": {
    }
}

ФССП

Проверка задолженностей по номеру исполнительного производства

Описание

Метод предназначен для получения информации об исполнительном производстве по номеру ИП из базы ФССП (Федеральная служба судебных приставов).
Сервис возвращает данные о должнике, задолженности, исполнительном документе и судебном приставе.

Общая информация

Параметр Значение
Метод POST
Endpoint /api/v5/fssp/single/ip

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

Параметр Где передают Тип Обязателен Описание
ipNumber body string да Номер исполнительного производства (формат: XXXXXX/XX/XXXXX-ИП)

Параметры ответа

Параметр Тип Описание
id string Уникальный идентификатор запроса
cost string Стоимость запроса
method string Название метода: fssp_by_ip
request object Контейнер с параметрами запроса
is_error bool Флаг ошибки (true - ошибка, false - нет)
is_completed bool Успешность выполнения (true - успех, false - ошибка)
result array Результат с информацией об исполнительном производстве

Поля в result

Параметр Тип Описание
totalDebt integer Общая сумма задолженности (руб.)
totalPayment integer Общая сумма платежей (руб.)
totalExecutiveFee integer Общая сумма исполнительского сбора (руб.)
charges array Массив начислений/взысканий

Поля в charges

Параметр Тип Описание
debtor string Данные должника (ФИО, дата рождения, место рождения)
enforcement string Номер и дата исполнительного производства
requisites string Реквизиты исполнительного документа
reason string Причина взыскания
totalDebt integer Сумма задолженности по данному взысканию (руб.)
payment string Описание платежа и сумма
debt integer Текущая задолженность (руб.)
executiveFee integer Исполнительский сбор (руб.)
bailiffDepartment string Отдел судебных приставов (название и адрес)
bailiff string ФИО судебного пристава
process_title string Номер исполнительного производства
process_date string Дата возбуждения производства (YYYY-MM-DD)
process_total string Итоговая сумма по производству
document_title string Название исполнительного документа
document_organization string Организация, выдавшая документ
document_type string Тип исполнительного документа
document_date string Дата документа (YYYY-MM-DD)
document_num string Номер документа
subjects array Массив предметов взыскания

Поля в subjects

Параметр Тип Описание
title string Название предмета взыскания
sum string Сумма взыскания (руб.)

Примечания

  • Номер ИП должен быть в формате XXXXXX/XX/XXXXX-ИП

  • Данные получаются из базы ФССП России

  • Поля с разделителем | содержат несколько значений, разделенных вертикальной чертой

  • Суммы указаны в рублях

Authorizations:
basicAuth
Request Body schema: application/json
required
ipNumber
required
string

Responses

Request samples

Content type
application/json
{
  • "ipNumber": "248967/24/50034-ИП"
}

Response samples

Content type
application/json
{
  • "response": {
    }
}

Проверка благонадёжности

Асинхронная проверка: POST создаёт задачу, GET с полученным task_id забирает отчёт. Пока is_completed = false — отчёт ещё собирается.

Авторизация — заголовок Authorization: Basic {{TOKEN}}.

Создать задачу проверки

POST /api/v5/trust-check/task

Создание задачи на формирование отчёта. После получения task_id — polling через GET.

Параметры запроса (body)

Параметр Тип Обязателен Описание
last_name string да Фамилия
first_name string да Имя
mid_name string null нет
birth_date string (DD.MM.YYYY) да Дата рождения
passport_number string (10 цифр) да Серия + номер паспорта без пробелов
passport_date string (DD.MM.YYYY) да Дата выдачи паспорта
phone string нет Мобильный телефон, 11 цифр без + (например 79990001122)
driver_license_number string нет Серия + номер ВУ (4 символа: цифры или кириллица + 6 цифр)
driver_license_date string (DD.MM.YYYY) нет Дата выдачи ВУ
inn string (12 цифр) нет ИНН

Валидация

Поле Формат Пример
last_name / first_name / mid_name Кириллица + дефис + пробел Тестов
birth_date / passport_date / driver_license_date DD.MM.YYYY 10.01.1990
passport_number 10 цифр 1234567890
phone 11 цифр без + 79990001122
driver_license_number 4 символа (цифры или кириллица) + 6 цифр, либо пустая строка АА123456
inn 12 цифр 123456789012

Какие поля нужны для каких проверок

Если в запросе не передан параметр, необходимый для конкретной проверки (например driver_license_number + driver_license_date для проверки ВУ), соответствующий блок в отчёте вернётся как null.

Блок отчёта Поля запроса, необходимые для проверки
passport last_name, first_name, birth_date, passport_number, passport_date
driver_license driver_license_number, driver_license_date
inn last_name, first_name, birth_date, passport_number
phone_match last_name, first_name, phone
credit_score last_name, first_name, birth_date, passport_number, passport_date
tax_debts inn
fssp_executions last_name, first_name, birth_date
alimony_debts last_name, first_name, birth_date
bankruptcy last_name, first_name, inn
terror_list last_name, first_name, birth_date
foreign_agent last_name, first_name, inn
sanctions last_name, first_name
disqualified last_name, first_name, birth_date
nominal_chief last_name, first_name, inn
mvd_wanted last_name, first_name, birth_date
fssp_wanted last_name, first_name, birth_date
fsin_wanted last_name, first_name, birth_date
criminal_courts last_name, first_name, mid_name, birth_date
arbitrage_courts inn
affiliation inn
self_employed inn
movable_pledges last_name, first_name, mid_name, birth_date

Параметры ответа (успех)

Параметр Тип Описание
task_id string (UUID) ID задачи для polling через GET
id string Уникальный идентификатор запроса

Параметры ответа (ошибка валидации)

Параметр Тип Описание
message string Описание ошибки
id string Уникальный идентификатор запроса

Сообщения ошибок валидации

HTTP message Описание
400 last_name is required Не передана фамилия
400 first_name is required Не передано имя
400 birth_date is required Не передана дата рождения
400 passport_number is required Не передан паспорт
400 passport_date is required Не передана дата выдачи паспорта
400 passport_number must be 10 digits Неверный формат паспорта
400 inn must be 12 digits Неверный формат ИНН
400 phone must be 11 digits Неверный формат телефона
400 driver_license_number must match 4 chars + 6 digits Неверный формат номера ВУ
400 birth_date must be DD.MM.YYYY Неверный формат даты
400 invalid payload format Невалидный JSON / тип поля
Authorizations:
basicAuth
Request Body schema: application/json
required
last_name
required
string

Фамилия

first_name
required
string

Имя

mid_name
required
string

Отчество

birth_date
required
string

Дата рождения в формате ДД.ММ.ГГГГ

passport_number
required
string

Серия и номер паспорта без пробелов, 10 цифр

passport_date
required
string

Дата выдачи паспорта в формате ДД.ММ.ГГГГ

phone
required
string

Номер телефона в формате 79990001122

driver_license_number
required
string

Серия и номер водительского удостоверения без пробелов

driver_license_date
required
string

Дата выдачи водительского удостоверения в формате ДД.ММ.ГГГГ

inn
required
string

ИНН физического лица, 12 цифр

Responses

Request samples

Content type
application/json
{
  • "last_name": "Тестов",
  • "first_name": "Тест",
  • "mid_name": "Тестович",
  • "birth_date": "10.01.1990",
  • "passport_number": "1234567890",
  • "passport_date": "10.01.2010",
  • "phone": "79990001122",
  • "driver_license_number": "",
  • "driver_license_date": "10.12.2020",
  • "inn": "123456789012"
}

Response samples

Content type
application/json
{
  • "task_id": "014705fc-1243-426e-a6bc-6cdc4a428c64",
  • "id": "65465465465"
}

Получить результат по task_id

GET /api/v5/trust-check/task?task_id={uuid}

Получение результатов проверки. Клиент опрашивает этот эндпоинт каждую 1 минуту, пока response.is_completed не станет true.

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

Параметр Тип Описание
task_id string (UUID) UUID задачи (получен в response.result[0].task_id от POST)

Состояния ответа (по result[])

Состояние is_completed is_error result[]
Задача в pending false false [] — пусто, продолжаем polling
Отчёт готов true false [{ summary, passport, ..., self_employed }] — отчёт с 22 блоками
Глобальная ошибка true true [{ error_code, message }]

Структура отчёта (result[0])

Отчёт состоит из 22 блоков проверки. У каждого блока есть 2 общих булевых поля: is_error (тех. ошибка) и is_found (что-то нашли). Остальные поля специфичны для проверки.

Общие поля каждого блока

Поле Тип Описание
is_error bool true — конкретная проверка упала с тех. ошибкой (источник недоступен)
is_found bool true — по физлицу что-то нашли в этой проверке

Комбинации:

is_error is_found Смысл
false true Проверка отработала, данные нашлись
false false Проверка отработала, по физлицу ничего нет
true false Тех. ошибка проверки — данные не получены

Дополнительно: блок может быть null — это значит, что в запросе не были переданы параметры, необходимые для этой проверки (см. таблицу обязательных параметров в разделе "1. Создание задачи").

Описание полей по блокам

passport — Паспорт (соответствие ФИО и действительность)

Поле Тип Описание
score int 100 = ФИО+ДР+паспорт верифицированы; 80 = ФИО+номер OK, в ДР опечатки; 50 = Ф+И+номер OK; 10 = не найден; 0 = недействителен
description string Текстовое описание результата
issue_date_verified bool Дата выдачи верифицирована

driver_license — Водительское удостоверение

Поле Тип Описание
status string "Действует" / "Недействителен"
number string Номер ВУ
issue_date string (YYYY-MM-DD) Дата выдачи
expiry_date string (YYYY-MM-DD) Срок действия
categories array Массив категорий (например ["B","B1"])
person_birth_date string (YYYY-MM-DD) Дата рождения владельца
disqualifications array Массив решений о лишении (см. поля ниже)
disqualifications[].state string Статус решения
disqualifications[].decision_date string (YYYY-MM-DD) Дата вступления решения в силу
disqualifications[].period string Период лишения (например "6 месяцев")
disqualifications[].place_of_birth string Место рождения
disqualifications[].region string Регион
disqualifications[].comment string Комментарий

inn — ИНН

Поле Тип Описание
value string (12 цифр) ИНН

phone_match — Соответствие ФИО ↔ телефон

Поле Тип Описание
description string Текстовое описание

credit_score — БКИ-скоринг

Поле Тип Описание
score int 0=не найдено; 1-550=крайне плохой; 550-600=плохой; 600-650=средний; >650=хороший
default_probability float Вероятность дефолта (0..1)
exclusion_code string 0=ok; 1=системная ошибка; 2=скончавшийся; 3=мошенничество; 4,5=недостаточно данных; 6=данные устарели
status string Статус скоринга

tax_debts — Налоговая задолженность (ФНС)

Поле Тип Описание
items array Массив долгов
items[].created_at string (YYYY-MM-DD) Дата появления долга
items[].amount string Сумма
items[].info string Описание типа налога
status string Доменный статус

fssp_executions — Исполнительные производства ФССП

Поле Тип Описание
items array Массив производств
items[].debtor_name string ФИО должника
items[].debtor_birth_date string (YYYY-MM-DD) Дата рождения должника
items[].debtor_address string Адрес должника
items[].processings string Номер и дата ИП
items[].document string Документ-основание
items[].document_issuer string Орган, выдавший документ
items[].ended_at string (YYYY-MM-DD) null
items[].reason_article string Статья основания
items[].reason_part string Часть
items[].reason_paragraph string Пункт
items[].subject string Предмет исполнения
items[].amount string Сумма
items[].department_name string Отдел ФССП
items[].department_address string Адрес отдела
items[].executor_name string ФИО пристава
items[].executor_contacts array Контакты пристава
items[].region string Регион

alimony_debts — Алименты (ФССП)

Поле Тип Описание
items array Массив производств
items[].debtor_name string ФИО должника
items[].debtor_birth_date string (YYYY-MM-DD) Дата рождения должника
items[].debtor_address string Адрес
items[].processings string Номер и дата ИП
items[].document string Документ-основание
items[].document_issuer string Орган, выдавший
items[].started_at string (YYYY-MM-DD) Дата начала ИП
items[].document_date string (YYYY-MM-DD) Дата документа
items[].subjects array Массив назначений (см. ниже)
items[].subjects[].subject string Назначение
items[].subjects[].amount string Сумма
items[].department_name string Отдел ФССП
items[].department_address string Адрес отдела
items[].executor_name string ФИО пристава
items[].executor_contacts array Контакты
items[].region string Регион

bankruptcy — ЕФРСБ (банкротство)

Поле Тип Описание
total_count int Всего записей в реестре
items array Записи реестра
items[].category string Статус должника ("Завершено" / "Открыто" / ...)
items[].debtor_name string ФИО должника
items[].inn string ИНН
items[].ogrn string ОГРНИП
items[].snils string СНИЛС
items[].region string Регион
items[].address string Адрес

terror_list — Реестр террористов и экстремистов

Поле Тип Описание
items array Записи реестра
items[].last_name string Фамилия
items[].first_name string Имя
items[].mid_name string Отчество
items[].info string Дополнительная информация

foreign_agent — Иностранные агенты

Поле Тип Описание
items array Записи реестра
items[].name string ФИО
items[].birth_date string (YYYY-MM-DD) Дата рождения
items[].inn string ИНН
items[].snils string СНИЛС
items[].included_at string (YYYY-MM-DD) Когда включён в реестр
items[].excluded_at string (YYYY-MM-DD) null

sanctions — Санкционные списки

Поле Тип Описание
items array Записи санкций
items[].name string ФИО
items[].name_eng string ФИО на английском
items[].birth_date string (YYYY-MM-DD) Дата рождения
items[].is_active bool Активна ли санкция
items[].started_at string (YYYY-MM-DD) Дата начала
items[].ended_at string (YYYY-MM-DD) null
items[].additional_info string Доп. информация
items[].active_sanctions string Список ограничений
items[].source string (enum) Источник: OFAC / EU / UK / ...

disqualified — Реестр дисквалифицированных лиц

Поле Тип Описание
items array Записи реестра
items[].rdl_number string Номер записи в РДЛ
items[].last_name string Фамилия
items[].first_name string Имя
items[].mid_name string Отчество
items[].birth_date string (YYYY-MM-DD) Дата рождения
items[].place_of_birth string Место рождения
items[].company string Организация
items[].company_inn string ИНН организации
items[].post string Должность
items[].article string Статья КоАП
items[].agency string Орган, составивший протокол
items[].judge_full_name string ФИО судьи
items[].judge_post string Должность судьи
items[].period_text string Текстовое описание периода
items[].started_at string (YYYY-MM-DD) Дата начала дисквалификации
items[].ended_at string (YYYY-MM-DD) Дата окончания

nominal_chief — Номинальные директоры

Поле Тип Описание
items array Записи
items[].last_name string Фамилия
items[].first_name string Имя
items[].mid_name string Отчество
items[].inn string ИНН
items[].companies_count int В скольких компаниях номинал

mvd_wanted — Розыск МВД

Поле Тип Описание
items array Записи розыска
items[].name string ФИО
items[].sex string Пол ("М" / "Ж")
items[].birth_date string (YYYY-MM-DD) Дата рождения
items[].place_of_birth string Место рождения
items[].reason string Основание для розыска
items[].info string Дополнительная информация

fssp_wanted — Розыск ФССП

Поле Тип Описание
items array Записи розыска
items[].last_name string Фамилия
items[].first_name string Имя
items[].mid_name string Отчество
items[].birth_date string (YYYY-MM-DD) Дата рождения
items[].region string Регион розыска
items[].created_at string (YYYY-MM-DD) Когда поставили в розыск

fsin_wanted — Розыск ФСИН

Поле Тип Описание
items array Записи розыска
items[].last_name string Фамилия
items[].first_name string Имя
items[].mid_name string Отчество
items[].birth_date string (YYYY-MM-DD) Дата рождения
items[].info string Дополнительная информация
items[].url string Ссылка на страницу
items[].created_at string (YYYY-MM-DD) Когда поставили в розыск

criminal_courts — Уголовные / административные / гражданские суды

Поле Тип Описание
items array Массив дел
items[].url string Ссылка на дело на сайте суда
items[].case_number string Номер дела
items[].case_date string (YYYY-MM-DD) Дата поступления дела
items[].result string Решение по делу
items[].court_name string Наименование суда
items[].article string Статья УК РФ / КоАП РФ
items[].category string (enum) Вид судопроизводства: гражданское / административное / уголовное
items[].role string (enum) Сторона по делу: Истец / Ответчик / Обвиняемый / Привлекаемое лицо / Административный ответчик / ...

arbitrage_courts — Арбитражные суды

Поле Тип Описание
total_count int Всего дел
respondent_count int В качестве ответчика
plaintiff_count int В качестве истца
third_person_count int В качестве третьего лица
other_person_count int В ином качестве
items array Массив дел
items[].case_number string Номер дела
items[].type string Тип дела
items[].case_date string (YYYY-MM-DD) Дата открытия
items[].state string Статус
items[].is_finished bool Закрыто
items[].amount string null
items[].respondents array Ответчики (см. структуру лица ниже)
items[].plaintiffs array Истцы (та же структура)
items[].third_persons array Третьи лица (та же структура)
items[].other_persons array Иные лица (та же структура)
items[].instances array Инстанции (см. структуру ниже)

Структура respondents[] / plaintiffs[] / third_persons[] / other_persons[]

Поле Тип Описание
name string Наименование / ФИО участника
inn string ИНН
ogrn string ОГРН
address string Адрес

Структура instances[]

Поле Тип Описание
id string id
number string Номер инстанции
type string Тип инстанции (например "Первая инстанция", "Апелляционная инстанция")
additional_info string Дополнительная информация
judges array ФИО судей
court_code string Код суда (например NOVOSIB, 17AAS)
court_name string Полное название суда
decision_file_name string null
decision_file_url string null
events array События в рамках инстанции (см. ниже)

Структура instances[].events[]

Поле Тип Описание
id string UUID события (может быть пустым)
type string Тип документа: "Решение", "Определение", "Жалоба", "Заявление (исковое заявление)", "Ходатайство (заявление)", "Письмо" и др.
type_id string (UUID) UUID типа документа
additional_info string Доп. инфо (штрихкод, дата заседания и т.п.)
file string URL файла документа (PDF на сайте суда)
registered_at string (YYYY-MM-DD) Дата регистрации события
published_at string (ISO 8601) Дата публикации события (с часовым поясом)
is_last_event bool null
content_type string Тип содержимого: "Отказать в иске", "Возврат госпошлины", "О возвращении апелляционной жалобы" и др.
declarer string Заявитель (если событие инициировано стороной)
comment string null
decision_type string null
is_signed bool Электронная подпись
amount string Сумма (если применимо, иначе "0")

affiliation — Аффилированность с ЮЛ/ИП

Три подсписка: founder_of (учредитель), ceo_of (директор), ip (ИП).

Поле Тип Описание
founder_of array Учредитель в ЮЛ
founder_of[].company_name string Наименование компании
founder_of[].object_type string Тип юрлица ("ООО" / ...)
founder_of[].inn string ИНН
founder_of[].kpp string КПП
founder_of[].ogrn string ОГРН
founder_of[].registered_at string (YYYY-MM-DD) Дата регистрации
founder_of[].status string Статус компании ("Действующая" / ...)
founder_of[].capital string Уставный капитал
founder_of[].shares array Доли (см. ниже)
founder_of[].shares[].company_grn long ОГРН
founder_of[].shares[].shares_percent int Процент доли
founder_of[].shares[].shares_value int Размер доли
founder_of[].shares[].is_actual bool Актуальность
ceo_of array Директор ЮЛ
ceo_of[].company_name string Наименование
ceo_of[].type string Тип
ceo_of[].inn string ИНН
ceo_of[].ogrn string ОГРН
ceo_of[].registered_at string (YYYY-MM-DD) Дата регистрации
ceo_of[].closed_at string (YYYY-MM-DD) null
ceo_of[].is_active string (enum) "Active" (действующая) / "Terminated" (ликвидирована)
ceo_of[].capital string Уставный капитал
ceo_of[].okved string ОКВЭД
ip array ИП
ip[].name string Наименование ИП
ip[].inn string ИНН ИП
ip[].ogrn string ОГРНИП
ip[].okved string ОКВЭД
ip[].registered_at string (YYYY-MM-DD) Дата регистрации ИП
ip[].status string Статус ИП ("Active" / ...)

movable_pledges — Залоги движимого имущества (ФНП)

Поле Тип Описание
items array Массив залогов
items[].registered_at string (YYYY-MM-DD) Дата регистрации
items[].reference_number string Номер уведомления
items[].properties array Идентификаторы предмета залога
items[].properties[].type string (enum) vin / id / other
items[].properties[].value string Значение
items[].pledgors array Залогодатели
items[].pledgors[].name string ФИО залогодателя
items[].pledgors[].birth_date string (YYYY-MM-DD) Дата рождения
items[].pledgees array Залогодержатели
items[].pledgees[].name string ФИО залогодержателя
items[].pledgees[].birth_date string (YYYY-MM-DD) Дата рождения
items[].history array История изменений
items[].history[].changed_at string (YYYY-MM-DD) Когда изменилось
items[].history[].type string (enum) Возникновение / Прекращение / ...
items[].history[].number string Регистрационный номер

self_employed — Самозанятый (НПД, ФНС)

Кроме общих is_error / is_found других полей нет. is_found: true = физлицо является плательщиком налога на профессиональный доход (самозанятым).

Коды глобальных ошибок (error_code)

Код Имя Описание Retry на стороне клиента
1 InternalError Внутренняя ошибка микросервиса нет
2 InvalidPayload Ошибка валидации / неизвестный task_id нет
3 ExternalGeneral Ошибка внешнего источника (timeout, 5xx) да
Authorizations:
basicAuth
query Parameters
task_id
required
string
Example: task_id={{task_id}}

Responses

Response samples

Content type
application/json
Example
{
  • "response": {
    }
}

Благонадёжность — индивидуальные проверки

Проверка благонадёжности — индивидуальные проверки

Набор отдельных поштучных проверок физического лица. Каждая ручка вызывается независимо (в отличие от комплексного отчёта «Проверка благонадёжности (trust-check)»).

Общая информация

Параметр Значение
Base URL https://bad-api.bigautodata.ru
Авторизация заголовок Authorization: Basic {{TOKEN}}
Content-Type application/json
Тип синхронный — POST сразу возвращает результат

Формат ответа

Единый конверт response: id, cost, method, is_error, is_completed, request (эхо параметров), result[].

Коды ошибок

error_code HTTP Значение retry
1 500 Внутренняя ошибка false
2 400 Ошибка валидации (request: null) false
3 500 Временная ошибка внешнего источника true

Ручки

Ручка Эндпоинт
Банкротство ФЛ (ЕФРСБ) POST /api/v5/trust-check/bankrupt-person
Банкротные дела (арбитраж) POST /api/v5/trust-check/bankrupt-kad
Судебные дела POST /api/v5/trust-check/sud-criminal
Арбитражные дела POST /api/v5/trust-check/arbitration-cases
Задолженность в ФССП POST /api/v5/trust-check/fssp
Получение ИНН POST /api/v5/trust-check/get-inn
Комплексная проверка паспорта POST /api/v5/trust-check/passport-complex

Проверка банкротства ФЛ — POST /api/v5/trust-check/bankrupt-person

Проверка банкротства физлица (ЕФРСБ)

Описание

Синхронная проверка физлица по реестру ЕФРСБ. Поиск по ФИО (опционально — адрес) либо по коду должника.

Общая информация

Параметр Значение
Метод POST
Endpoint /api/v5/trust-check/bankrupt-person
Наименование в ответе bankrupt-person

Авторизация

В заголовке Authorization: Basic {{TOKEN}}.

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

Параметр Тип Обязателен Описание
last_name string да* Фамилия
first_name string да* Имя
mid_name string нет Отчество
address string нет Адрес для уточнения поиска; допустима пустая строка
code string да* Код должника; альтернатива поиску по ФИО

* Нужно передать либо ФИО, либо code. Если не передано ни то, ни другое — error_code = 2, message = "Требуется либо ФИО, либо code".

Envelope ответа

Параметр Тип Описание
response.id string Идентификатор запроса
response.cost number null
response.method string bankrupt-person
response.request object null
response.is_error bool Флаг ошибки
response.is_completed bool Проверка завершена
response.result array Найденные записи либо [{ error_code, message }]

Поля в result[]

Параметр Тип Описание
category string Категория должника
debtor_name string ФИО должника
inn string ИНН
ogrn string ОГРН (для ФЛ обычно пусто)
snils string СНИЛС
region string Регион
address string Адрес
place_of_birth string Место рождения
birth_date string Дата рождения, YYYY-MM-DD
messages array Публикации по должнику
messages[].publication_type string Тип публикации
messages[].number string Номер сообщения
messages[].published_at string Дата публикации, YYYY-MM-DD
messages[].is_annulled bool Признак аннулирования
messages[].type string Тип сообщения
messages[].act_type string Тип судебного акта

Состояния ответа

Состояние HTTP Смысл
result = [{…}] 200 Записи найдены
result = [] 200 Записей нет
error_code = 2 400 Ошибка валидации, request = null
error_code = 3 200 Ошибка источника (временная, можно повторить)
— 401 Не передан или недействителен Authorization

Коды ошибок (error_code)

error_code Описание retry
1 Внутренняя ошибка сервиса false
2 Ошибка валидации входных данных false
3 Временная ошибка источника true
Authorizations:
basicAuth
Request Body schema: application/json
required
last_name
required
string

Фамилия

first_name
required
string

Имя

mid_name
required
string

Отчество

address
required
string

Адрес

code
required
string

Код должника; альтернатива поиску по ФИО

Responses

Request samples

Content type
application/json
{
  • "last_name": "Ааб",
  • "first_name": "Наталия",
  • "mid_name": "Альбертовна",
  • "address": "",
  • "code": ""
}

Response samples

Content type
application/json
Example
{
  • "response": {
    }
}

Задолженность в ФССП — POST /api/v5/trust-check/fssp

Задолженность в ФССП

Описание

Синхронная проверка задолженностей физлица в банке данных исполнительных производств ФССП.

Общая информация

Параметр Значение
Метод POST
Endpoint /api/v5/trust-check/fssp
Наименование в ответе fssp-ext

Авторизация

В заголовке Authorization: Basic {{TOKEN}}.

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

Параметр Тип Обязателен Описание
last_name string да Фамилия
first_name string да Имя
mid_name string нет Отчество
birth_date string да Дата рождения, DD.MM.YYYY

Envelope ответа

Параметр Тип Описание
response.id string Идентификатор запроса
response.cost number | null Стоимость запроса
response.method string fssp-ext
response.request object | null Эхо параметров запроса; null при ошибке валидации
response.is_error bool Флаг ошибки
response.is_completed bool Проверка завершена
response.result array Результат либо [{ error_code, message }]

Поля в result[]

Параметр Тип Описание
is_error bool Ошибка на стороне источника по этому запросу
is_found bool Признак того, что производства найдены
total_debt number Общая сумма задолженности
open_debt number Сумма непогашенной задолженности
items array Исполнительные производства
items[].debtor_name string ФИО должника
items[].debtor_birth_date string Дата рождения должника, YYYY-MM-DD
items[].debtor_address string Адрес должника
items[].processings string Номер и дата исполнительного производства
items[].document string Реквизиты исполнительного документа
items[].document_issuer string Кем выдан документ
items[].ended_at string | null Дата окончания производства
items[].reason_article string | null Статья основания окончания
items[].reason_part string | null Часть статьи
items[].reason_paragraph string | null Пункт статьи
items[].subject string Предмет исполнения
items[].subject2 string Уточнение предмета исполнения
items[].amount string Сумма по производству
items[].amount2 string Остаток долга
items[].department_name string Подразделение ФССП
items[].department_address string Адрес подразделения
items[].executor_name string ФИО судебного пристава
items[].executor_contacts array Контакты пристава
items[].region string Регион

Состояния ответа

Состояние HTTP Смысл
is_found = true, items = [{…}] 200 Производства найдены
is_found = false, items = [] 200 Производств нет
error_code = 2 400 Ошибка валидации, request = null
error_code = 3 200 Ошибка источника (временная, можно повторить)
— 401 Не передан или недействителен Authorization

Коды ошибок (error_code)

error_code Описание retry
1 Внутренняя ошибка сервиса false
2 Ошибка валидации входных данных false
3 Временная ошибка источника true
Authorizations:
basicAuth
Request Body schema: application/json
required
last_name
required
string

Фамилия

first_name
required
string

Имя

mid_name
required
string

Отчество

birth_date
required
string

Дата рождения в формате ДД.ММ.ГГГГ

Responses

Request samples

Content type
application/json
{
  • "last_name": "Иванов",
  • "first_name": "Иван",
  • "mid_name": "Иванович",
  • "birth_date": "27.03.1970"
}

Response samples

Content type
application/json
Example
{
  • "response": {
    }
}

Получение ИНН — POST /api/v5/trust-check/get-inn

Получение ИНН

Описание

Синхронное получение ИНН физлица по ФИО, дате рождения и паспорту.

Общая информация

Параметр Значение
Метод POST
Endpoint /api/v5/trust-check/get-inn
Наименование в ответе get-inn

Авторизация

В заголовке Authorization: Basic {{TOKEN}}.

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

Параметр Тип Обязателен Описание
last_name string да Фамилия
first_name string да Имя
mid_name string нет Отчество
birth_date string да Дата рождения, DD.MM.YYYY
passport_number string да Серия и номер паспорта, 10 цифр без пробелов
passport_date string нет Дата выдачи паспорта, DD.MM.YYYY

Envelope ответа

Параметр Тип Описание
response.id string Идентификатор запроса
response.cost number | null Стоимость запроса
response.method string get-inn
response.request object | null Эхо параметров запроса; null при ошибке валидации
response.is_error bool Флаг ошибки
response.is_completed bool Проверка завершена
response.result array [{ inn }] либо [], либо [{ error_code, message }]

Поля в result[]

Параметр Тип Описание
inn string ИНН физлица, 12 цифр

Состояния ответа

Состояние HTTP Смысл
result = [{ inn }] 200 ИНН найден
result = [] 200 ИНН не найден
error_code = 2 400 Ошибка валидации, request = null
error_code = 3 200 Ошибка источника (временная, можно повторить)
— 401 Не передан или недействителен Authorization

Коды ошибок (error_code)

error_code Описание retry
1 Внутренняя ошибка сервиса false
2 Ошибка валидации входных данных false
3 Временная ошибка источника true
Authorizations:
basicAuth
Request Body schema: application/json
required
last_name
required
string

Фамилия

first_name
required
string

Имя

mid_name
required
string

Отчество

birth_date
required
string

Дата рождения в формате ДД.ММ.ГГГГ

passport_number
required
string

Серия и номер паспорта без пробелов, 10 цифр

passport_date
required
string

Дата выдачи паспорта в формате ДД.ММ.ГГГГ

Responses

Request samples

Content type
application/json
{
  • "last_name": "Иванов",
  • "first_name": "Иван",
  • "mid_name": "Иванович",
  • "birth_date": "20.01.1970",
  • "passport_number": "1234567890",
  • "passport_date": "22.12.2000"
}

Response samples

Content type
application/json
Example
{
  • "response": {
    }
}

Проверка паспорта — POST /api/v5/trust-check/passport-complex

Проверка паспорта

Описание

Комплексная проверка паспорта. Синхронная ручка: POST сразу возвращает результат в конверте response.

Авторизация

В заголовке Authorization: Basic {{TOKEN}} (base64 «логин:пароль»).

Общая информация

Параметр Значение
Метод POST
Endpoint /api/v5/trust-check/passport-complex
Версия V5
Наименование passport-complex

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

Параметр Где передают Тип Обязателен Описание
last_name body string да Кириллица, дефис, пробел, ^[А-ЯЁа-яё\- ]+$
first_name body string да Кириллица, дефис, пробел, ^[А-ЯЁа-яё\- ]+$
mid_name body string да* Кириллица, дефис, пробел (пустая строка, если отчества нет), ^[А-ЯЁа-яё\- ]\*$
birth_date body string да DD.MM.YYYY, ^\d{2}\.\d{2}\.\d{4}$
passport_number body string да 10 цифр (серия+номер слитно), ^\d{10}$
issue_date body string да DD.MM.YYYY, ^\d{2}\.\d{2}\.\d{4}$
extra body boolean нет boolean — вернуть действительность паспорта (mvd_status), `^(true

Параметры ответа

Параметр Тип Описание
response object Контейнер ответа
id string Идентификатор запроса
cost number null
method string Название метода
is_error bool Флаг ошибки
is_completed bool Готовность (true — выполнено)
request object null
result array Данные проверки или [{ error_code, message }] при ошибке

Поля в result

Параметр Тип Описание
score number
description string
issue_date_verified bool
mvd_status number

Состояния ответа

Состояние Смысл
is_completed = true, result = [{ score, … }] Результат проверки (score 0–100)
is_error = true, result = [{ error_code, message }] Ошибка проверки

У ручки нет отдельного состояния «не найдено»: результат всегда приходит числовым score.

Коды ошибок (error_code)

При ошибке result содержит [{ error_code, message }].

error_code Имя Описание retry
1 InternalError Внутренняя ошибка сервиса false
2 InvalidPayload Ошибка валидации входных данных false
3 ExternalGeneral Временная внешняя ошибка (timeout, 5xx) true
Authorizations:
basicAuth
Request Body schema: application/json
required
last_name
required
string

Фамилия

first_name
required
string

Имя

mid_name
required
string

Отчество

birth_date
required
string

Дата рождения в формате ДД.ММ.ГГГГ

passport_number
required
string

Серия и номер паспорта без пробелов, 10 цифр

issue_date
required
string

Дата выдачи удостоверения

extra
required
boolean

false)$`

Responses

Request samples

Content type
application/json
{
  • "last_name": "Иванов",
  • "first_name": "Иван",
  • "mid_name": "Иванович",
  • "birth_date": "01.01.1970",
  • "passport_number": "1234567890",
  • "issue_date": "01.01.2010",
  • "extra": true
}

Response samples

Content type
application/json
{
  • "response": {
    }
}

Водительское удостоверение

Проверка водительского удостоверения (асинхронная)

Проверка ВУ по данным водителя (ФИО, дата рождения, номер ВУ). Асинхронная модель: сначала создать задачу (POST), затем получить результат по task_id (GET).

Авторизация

В заголовке Authorization: Basic {{TOKEN}} (base64 «логин:пароль»).

Согласие на обработку персональных данных

С 27.07.2026 в теле POST обязательно передавать has_personal_data_consent: true — подтверждение того, что вы получили согласие субъекта на обработку персональных данных. Без него или со значением false задача не создаётся: HTTP 400, message = "Необходимо согласие на обработку персональных данных".

Коды ответов

  • Задача создана → HTTP 201, { id, task_id }.
  • Данные ещё не готовы → HTTP 200, is_completed = false (повторить GET).
  • Ошибка проверки → HTTP 200, is_error = true, is_completed = false.
  • Ошибка валидации при создании → HTTP 400, { id, message }.
  • Недействительный/отсутствующий токен → HTTP 401.

Время выполнения

Задача выполняется на стороне источника, типично несколько минут. Рекомендуемый интервал опроса GET — 15–30 секунд.

Проверка водительского удостоверения (асинхронная)

Проверка ВУ по данным водителя (ФИО, дата рождения, номер ВУ). Асинхронная модель: сначала создать задачу (POST), затем получить результат по task_id (GET).

Авторизация

В заголовке Authorization: Basic {{TOKEN}} (base64 «логин:пароль»).

Согласие на обработку персональных данных

С 27.07.2026 в теле POST обязательно передавать has_personal_data_consent: true — подтверждение того, что вы получили согласие субъекта на обработку персональных данных. Без него или со значением false задача не создаётся: HTTP 400, message = "Необходимо согласие на обработку персональных данных".

Коды ответов

  • Задача создана → HTTP 201, { id, task_id }.
  • Данные ещё не готовы → HTTP 200, is_completed = false (повторить GET).
  • Ошибка проверки → HTTP 200, is_error = true, is_completed = false.
  • Ошибка валидации при создании → HTTP 400, { id, message }.
  • Недействительный/отсутствующий токен → HTTP 401.

Время выполнения

Задача выполняется на стороне источника, типично несколько минут. Рекомендуемый интервал опроса GET — 15–30 секунд.

Создать проверку — POST /api/v5/driver-license

Проверка водительского удостоверения (асинхронная)

Проверка ВУ по данным водителя (ФИО, дата рождения, номер ВУ). Асинхронная модель: сначала создать задачу (POST), затем получить результат по task_id (GET).

Авторизация

В заголовке Authorization: Basic {{TOKEN}} (base64 «логин:пароль»).

Согласие на обработку персональных данных

С 27.07.2026 в теле POST обязательно передавать has_personal_data_consent: true — подтверждение того, что вы получили согласие субъекта на обработку персональных данных. Без него или со значением false задача не создаётся: HTTP 400, message = "Необходимо согласие на обработку персональных данных".

Коды ответов

  • Задача создана → HTTP 201, { id, task_id }.
  • Данные ещё не готовы → HTTP 200, is_completed = false (повторить GET).
  • Ошибка проверки → HTTP 200, is_error = true, is_completed = false.
  • Ошибка валидации при создании → HTTP 400, { id, message }.
  • Недействительный/отсутствующий токен → HTTP 401.

Время выполнения

Задача выполняется на стороне источника, типично несколько минут. Рекомендуемый интервал опроса GET — 15–30 секунд.

Authorizations:
basicAuth
Request Body schema: application/json
required
first_name
required
string

Имя

last_name
required
string

Фамилия

mid_name
required
string

Отчество

birth_date
required
string

Дата рождения в формате ДД.ММ.ГГГГ

driver_license_number
required
string

Серия и номер водительского удостоверения без пробелов

has_personal_data_consent
required
boolean

Согласие субъекта на обработку персональных данных получено

Responses

Request samples

Content type
application/json
{
  • "first_name": "Иван",
  • "last_name": "Иванов",
  • "mid_name": "Иванович",
  • "birth_date": "20.12.1900",
  • "driver_license_number": "9926751111",
  • "has_personal_data_consent": true
}

Получить результат — GET /api/v5/driver-license

Authorizations:
basicAuth
query Parameters
task_id
required
string
Example: task_id=2a2069b0-dac8-4e81-b699-c7bb100c2ae5

Responses

Проверка паспорта

Проверка паспорта

Проверка действительности паспорта

Описание

Метод предназначен для проверки действительности паспорта гражданина РФ по серии и номеру.

Сервис позволяет определить, является ли паспорт действительным (не числится в базе недействительных паспортов).

Общая информация

Параметр Значение
Метод POST
Endpoint /api/v5/passport/is-valid

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

Параметр Где передают Тип Обязателен Описание
series body string да Серия паспорта (4 цифры)
number body string да Номер паспорта (6 цифр)

Параметры ответа

Параметр Тип Описание
id string Уникальный идентификатор запроса
cost string Стоимость запроса
method string Название метода: passport-is-valid
request object Контейнер с параметрами запроса
is_error bool Флаг ошибки (true - ошибка, false - нет)
is_completed bool Успешность выполнения (true - успех, false - ошибка)
result array Результат проверки паспорта

Поля в result

Параметр Тип Описание
is_valid bool Признак действительности паспорта (true - действителен, false - недействителен)

Примечания

  • Серия паспорта должна содержать 4 цифры

  • Номер паспорта должен содержать 6 цифр

  • Проверка осуществляется по базе недействительных паспортов МВД РФ

Authorizations:
basicAuth
Request Body schema: application/json
required
series
required
string

Серия полиса

number
required
string

Номер полиса

Responses

Request samples

Content type
application/json
{
  • "series": "****",
  • "number": "******"
}

Response samples

Content type
application/json
{
  • "response": {
    }
}

Поиск организаций по ИНН/ОГРН

Метод предназначен для получения основных сведений о юридическом лице по ИНН или ОГРН.

В ответе возвращаются: название организации, организационно-правовая форма (ОПФ), ИНН, КПП, ОГРН, дата регистрации и юридический адрес.

Метод: POST

Endpoint: /api/v5/org/info/by-inn-ogrn

Примечания

  • При передаче только ИНН или ОГРН без КПП возвращаются данные головной компании.

  • При передаче ИНН/ОГРН + КПП возвращается филиал, соответствующий этому КПП.

Поиск организации по ИНН/ОГРН

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

Параметр Где передаётся Тип Обязателен Описание
inn body string одно из inn/ogrn обязательно ИНН организации (10 или 12 цифр)
ogrn body string одно из inn/ogrn обязательно ОГРН организации (13 или 15 цифр)
kpp body string нет КПП филиала (9 цифр). Если не указано – возвращаются данные головной компании

Параметры ответа

Параметр Тип Описание
id string Уникальный идентификатор запроса
method string Название метода: org_info_by_inn_ogrn
request object Контейнер с параметрами запроса
is_error bool Признак ошибки:
true – ошибка
false – ошибок нет
is_completed bool Признак завершённости:
true – успешно
false – ошибка
result array[object] Результат с найденной организацией

Поля в result

Параметр Тип Описание
name string Наименование организации (с ОПФ)
opf string Организационно-правовая форма
inn string ИНН
kpp string КПП
ogrn string ОГРН
registration_date string (yyyy-MM-dd) Дата регистрации компании
address string Юридический адрес
fio.surname string ! Только для ИП
Фамилия
fio.name string ! Только для ИП
Имя
fio.patronymic string ! Только для ИП
Отчество
Authorizations:
basicAuth
Request Body schema: application/json
required
inn
required
string

ИНН физического лица, 12 цифр

ogrn
required
string

ОГРН организации, 13 цифр

kpp
required
string

КПП филиала (9 цифр). Если не указано – возвращаются данные головной компании

Responses

Request samples

Content type
application/json
{
  • "inn": "352509470002",
  • "ogrn": "",
  • "kpp": ""
}

Response samples

Content type
application/json
Example
{
  • "response": {
    }
}

Юридические лица

Юр лица

Проверка контрагента — юридического лица или индивидуального предпринимателя — по ИНН или ОГРН. Каждая ручка отвечает на один вопрос и тарифицируется отдельно: карточка организации отдаёт реквизиты, руководителей, финансовые показатели и налоговую задолженность; остальные проверяют организацию по судебной картотеке и по реестрам ФНС.

Все ручки синхронные: POST сразу возвращает результат. Отсутствие сведений — это результат проверки, а не ошибка: is_error: false вместе с is_found: false означает «проверка прошла, сведений нет», и такой ответ тарифицируется. is_error: true означает, что проверка не выполнена, и утверждать по ней ничего нельзя.

Общая информация

Параметр Значение
Base URL https://bad-api.bigautodata.ru
Авторизация заголовок Authorization: Basic {{TOKEN}}
Content-Type application/json
Тип синхронный — POST сразу возвращает результат

Формат ответа

Единый конверт response: id, cost, method, is_error, is_completed, request (эхо параметров), result[]. В result[] всегда один элемент: при успехе — объект с is_found, total_count и items[], при ошибке — [{ error_code, message }].

Коды ошибок

error_code HTTP Значение retry
1 500 Внутренняя ошибка false
2 400 Ошибка валидации (request: null) false
3 500 Временная ошибка источника true

Ошибка авторизации приходит без конверта — плоский объект с единственным полем message.

Ручки

Ручка Эндпоинт
Карточка организации POST /api/v6/legal-info/company-card
Дисквалификация руководителей POST /api/v6/legal-info/disqualified
Ограничения по недостоверности POST /api/v6/legal-info/limitations

Такси

Назначение

Сервис позволяет определить, использовался ли автомобиль в качестве такси, и получить полную информацию о лицензии, если она была оформлена.

Поддерживается проверка по различным типам идентификаторов транспортного средства:

Тип идентификатора Описание
vin_number VIN-код - уникальный идентификационный номер автомобиля
number_plate Государственный регистрационный знак (ГРЗ)
car_body_number Номер кузова
chassis_number Номер шасси

Лицензии такси

Описание:

Метод возвращает информацию о наличии лицензии на использование транспортного средства в такси.

Позволяет получить данные о лицензии, статусе, сроках действия, регионе, а также основные характеристики ТС.

Если лицензия найдена: флаг used_in_taxi всегда будет true.

Метод: GET

Endpoint: /v5/taxi/license/by-{request_type}/{car_id}

Параметр Тип Обязателен Описание
request_type string да Тип идентификатора. Возможные значения: vin_number, number_plate, car_body_number, chassis_number
car_id string да Значение идентификатора: VIN, государственный номер, номер кузова или шасси

Возможные значения статуса лицензии (result.condition)

Значение Описание
Действует Лицензия активна. Автомобиль имеет право перевозить пассажиров как такси
Не действует Лицензия оформлялась, но в данный момент недействительна
Приостановлено Лицензия временно недействительна. Возможно, по решению регулятора
Аннулировано Лицензия была отозвана или признана недействительной окончательно

💡 Важно: даже если лицензия недействительна, поле used_in_taxi будет true, поскольку сам факт использования в такси подтверждён.

Параметры ответа

Параметр Тип Описание
id string Уникальный идентификатор запроса
cost string Стоимость запроса
method string Название сервиса - всегда taxi
request object Контейнер с параметрами, переданными в запросе
is_error bool Флаг ошибки.
true - при ошибке
false - ошибок нет
is_completed bool true - запрос выполнен успешно
false - при внутренней ошибке
result array Массив объектов с результатами. Каждый объект одна лицензия

Поля в result[]:

Параметр Тип Описание
used_in_taxi bool Признак использования в такси.
true - использовался или используетсяfalse - нет
license_date string Дата выдачи лицензии
validity_date string Срок действия лицензии
condition string Статус лицензии:
- Действует
- Не действует
- Приостановлено
- Аннулирована
update_date string Дата последнего обновления лицензии в системе
region string Регион, в котором выдана лицензия
region_num string Код региона
name string Название организации, оформившей лицензию
full_name string Полное наименование организации (если доступно)
inn string ИНН организации
ogrn_num string ОГРН организации
blank_no string Номер бланка лицензии (если доступен)
brand_model string Марка и модель ТС (как в источнике)
norm_mark string Нормализованное название марки (например, Toyota)
norm_model string Нормализованное название модели (например, Corolla)
reg_num string Государственный регистрационный знак
color string Цвет автомобиля
manufacturing_year string Год выпуска автомобиля
yellow_color int Флаг «жёлтого» цвета кузова.
1 - да
0 - нет
yellow_reg_num int Флаг «жёлтого» номера.
1 - да
0 - нет
Authorizations:
basicAuth
path Parameters
number_plate
required
string
Example: О479ХО22

Responses

Response samples

Content type
application/json
Example
{
  • "response": {
    }
}

Факт использования ТС в такси

Описание:
Метод позволяет проверить, использовался ли автомобиль как такси и была ли на него оформлена лицензия.

Сервис возвращает информацию о статусе лицензии, дате выдачи, сроке действия, регионе регистрации и характеристиках автомобиля.

Поиск осуществляется по одному из идентификаторов: VIN, ГРЗ, кузов или шасси.

Метод: GET

Endpoint: v5/taxi/usage/by-{request_type}/{car_id}

Параметр Тип Обязателен Описание
request_type string да Тип идентификатора. Возможные значения: vin_number, number_plate, car_body_number, chassis_number
car_id string да Значение идентификатора: VIN, государственный номер, номер кузова или шасси

Параметры ответа

Параметр Тип Описание
id string Уникальный идентификатор запроса
cost string Стоимость запроса
method string Название сервиса: здесь всегда taxi
request object Контейнер с параметрами, использованными в запросе
vin_number string VIN транспортного средства
is_error bool false - ошибок не было,
true - возникла ошибка
is_completed bool true - запрос успешно выполнен, false - ошибка
result array Массив с результатами проверки
used_in_taxi bool Признак использования в такси:
true - использовался или используется
false - не использовалс
Authorizations:
basicAuth
path Parameters
number_plate
required
string
Example: XW7BZYHK40S112140

Responses

Response samples

Content type
application/json
Example
{
  • "response": {
    }
}

Лизинг

Коллекция для клиентской ручки лизинга.

Метод предназначен для получения сведений о договоре финансовой аренды (лизинга) по VIN транспортного средства.

Лизинг по VIN

Описание: возвращает сведения о договоре финансовой аренды (лизинга) по VIN транспортного средства.

Наименование: leasing
Метод: POST

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

Параметр Тип Обязателен Описание
vin string да VIN транспортного средства

Параметры ответа

Поле Тип Описание
response object Контейнер с ответом
id string Идентификатор запроса
cost null Стоимость запроса
method string Название метода: leasing
request object Эхо-запрос
vin string VIN транспортного средства
is_error bool false — ошибок нет; true — ошибка
is_completed bool false — ошибка; true — ошибок нет
result[] array Массив сведений о лизинге

Поля в result[]

Параметр Тип Описание
guid string GUID сообщения
number string Номер сообщения
datePublish string(datetime) Дата публикации сообщения
messageType string Тип сообщения
typeName string Наименование типа сообщения
startDate string(datetime) Дата начала периода лизинга
endDate string(datetime) Дата окончания периода лизинга
isSubleaseContract boolean Признак договора сублизинга
contractNumber string Номер договора
contractDate string(datetime) Дата договора
subjects array Сведения о предмете лизинга
lessors array Сведения о лизингодателях
lessees array Сведения о лизингополучателях
publisherInfo object Сведения о publisher
docs array Список документов
Authorizations:
basicAuth
Request Body schema: application/json
required
vin
required
string

VIN транспортного средства

Responses

Request samples

Content type
application/json
{
  • "vin": "XTT316300T1008817"
}

Response samples

Content type
application/json
Example
{
  • "response": {
    }
}

Аукционы и рыночная стоимость

Аукционы

Описание:

Метод предназначен для получения информации об участиях транспортного средства на аукционах по VIN.

В ответе можно определить, выставлялась ли машина на аукцион, а также получить сведения о площадках, датах проведения и сопутствующие данные.

Метод: POST

Endpoint: /api/v5/auctions

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

Параметр Где передаются Тип Обязателен Описание
host URL string да Корневой адрес сервиса: https://bad-api.bigautodata.ru/api/
version path string да Версия API: v5

Тело запроса:

Параметр Тип Обязателен Описание
vin_number string да VIN транспортного средства

Пример запроса:

curl --location 'https://bad-api.bigautodata.ru/api/v5/auctions' \
--header 'accept: application/json' \
--header 'authorization: Basic <ТОКЕН>' \
--header 'Content-Type: application/json' \
--data '{
  "vin_number": "WDD2229641A350572"
}'

Параметры ответа

Параметр Тип Описание
id string Уникальный идентификатор запроса
cost string Стоимость запроса
method string Название метода: auctions
request object Контейнер с параметрами запроса
request.vin_number string VIN транспортного средства
is_error bool Флаг ошибки
true – ошибка
false – ошибок нет
is_completed bool Флаг завершённости
true – успешно
false – ошибка
result array[object] Контейнер с информацией по аукционам

Поля в result

Параметр Тип Описание
auction bool Признак участия автомобиля в аукционах
true – выставлялся
false – не найдено
auction_dates array[object] Список записей о конкретных аукционах

Поля в auction_dates****:

Параметр Тип Описание
portal string Наименование площадки аукциона
region string Регион проведения аукциона
date string (ISO 8601) Дата проведения аукциона
images array Список изображений с аукциона (если доступны)
Authorizations:
basicAuth
Request Body schema: application/json
required
vin_number
required
string

VIN транспортного средства

Responses

Request samples

Content type
application/json
{
  • "vin_number": "WDD2229641A350572"
}

Response samples

Content type
application/json
{
  • "response": {
    }
}

Аукционы + рыночная стоимость

Описание:

Метод предназначен для получения информации об аукционах и рыночной стоимости транспортного средства по VIN.

В ответе можно определить, участвовало ли авто в аукционах, а также получить сведения о текущей рыночной стоимости.

Метод: POST

Endpoint: /api/v5/auctions-with-price

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

Параметр Где передаются Тип Обязателен Описание
host URL string да Корневой адрес сервиса: https://bad-api.bigautodata.ru/api/
version path string да Версия API: v5

Тело запроса:

Параметр Тип Обязателен Описание
vin_number string да VIN транспортного средства

Пример запроса:

curl --location 'https://bad-api.bigautodata.ru/api/v5/auctions-with-price' \
--header 'accept: application/json' \
--header 'authorization: Basic <ТОКЕН>' \
--header 'Content-Type: application/json' \
--data '{
  "vin_number": "WDD2229641A350572"
}'

Параметры ответа

Параметр Тип Описание
id string Уникальный идентификатор запроса
cost string Стоимость запроса
method string Название метода: auctions_with_price
request object Контейнер с параметрами запроса
request.vin_number string VIN транспортного средства
is_error bool Флаг ошибки
true – ошибка
false – ошибок нет
is_completed bool Флаг завершённости
true – успешно
false – ошибка
result array[object] Контейнер с данными по аукционам и стоимости

Поля в result

Параметр Тип Описание
auction bool Признак участия автомобиля в аукционах
true – выставлялся
false – не найдено
vhk_cost int Текущая рыночная стоимость автомобиля
auction_records array[object] Список записей о конкретных аукционах

Поля в auction_records****:

Параметр Тип Описание
portal string Наименование площадки аукциона
region string Регион проведения аукциона
date string (ISO 8601) Дата проведения аукциона
images array Список изображений с аукциона (если доступны)
Authorizations:
basicAuth
Request Body schema: application/json
required
vin_number
required
string

VIN транспортного средства

Responses

Request samples

Content type
application/json
{
  • "vin_number": "WDD2229641A350572"
}

Response samples

Content type
application/json
{
  • "response": {
    }
}

Рыночная стоимость

Описание

Метод предназначен для получения рыночной стоимости автомобиля по VIN-номеру, ГРЗ или типу кузова.
Сервис возвращает среднюю рыночную цену, диапазон цен и информацию о пробеге.

Общая информация

Параметр Значение
Метод POST
Endpoint /api/v5/vehicle-fields/vehicle-market-price

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

Параметр Где передают Тип Обязателен Описание
vin body string нет VIN-номер автомобиля (17 символов)
grz body string нет Государственный регистрационный знак
body body string нет Тип кузова автомобиля

Параметры ответа

Параметр Тип Описание
id string Уникальный идентификатор запроса
cost string Стоимость запроса
method string Название метода: market_price
request object Контейнер с параметрами запроса
is_error bool Флаг ошибки (true - ошибка, false - нет)
is_completed bool Успешность выполнения (true - успех, false - ошибка)
result array Результат с информацией о стоимости

Поля в result

Параметр Тип Описание
mileage integer Пробег автомобиля (км)
avgMarketPrice integer Средняя рыночная цена (руб.)
avgMileage integer Средний пробег (км)
avgPriceWithCondition integer Средняя цена с учетом состояния (руб.)
avgYear integer Средний год выпуска
maxNormalPrice integer Максимальная нормальная цена (руб.)
minNormalPrice integer Минимальная нормальная цена (руб.)
maxPrice integer Максимальная цена на рынке (руб.)
minPrice integer Минимальная цена на рынке (руб.)

Пример запроса

{
  "body": "string",
  "grz": "string",
  "vin": "Z94G2813BKR170705"
}

Примечания

  • VIN-номер должен содержать 17 символов

  • Можно передать VIN, ГРЗ или тип кузова для идентификации автомобиля

  • Цены указаны в рублях

  • Пробег указан в километрах

Authorizations:
basicAuth
Request Body schema: application/json
required
body
required
string
grz
required
string

Государственный регистрационный знак

vin
required
string

VIN транспортного средства

Responses

Request samples

Content type
application/json
{
  • "body": "string",
  • "grz": "string",
  • "vin": "Z94G2813BKR170705"
}

Response samples

Content type
application/json
{
  • "response": {
    }
}

Залоги

Описание

Получение информации о залогах транспортного средства по VIN-номеру.

Общая информация

Параметр Значение
Метод GET
Endpoint /api/v5/vehicle-fields/pledges/by-vin-number/{vin_number}

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

Параметр Где передают Тип Обязателен Описание
vin_number path string да VIN транспортного средства

Параметры ответа

Параметр Тип Описание
id string Уникальный идентификатор запроса
cost string Стоимость запроса
method string Используемый сервис
request object Контейнер для параметров, полученных в запросе
is_error bool Флаг ошибки (true — ошибка (внутренняя, источника 4ХХ или 5ХХ кроме таймаута), false — нет)
is_completed bool Успешность выполнения (true — успех, false — ошибка (внутренняя, источника 4ХХ или 5ХХ кроме таймаута))
result object Контейнер, содержащий информацию о залогах

Поля в request

Параметр Тип Описание
vin_number string VIN транспортного средства

Поля в result

Параметр Тип Описание
pledgors object Контейнер с данными о залогодателе
pledgees object Контейнер с данными о залогодержателе
history object Контейнер с историей действий по имуществу

Поля в pledgors

Параметр Тип Описание
type string Тип залогодателя. Возможные значения: Private person — Физическое Лицо, Organization — Юридическое Лицо
name string Наименование залогодателя
birthday string День рождения залогодателя. Заполняется только если тип — Физическое Лицо

Поля в pledgees

Параметр Тип Описание
type string Тип залогодержателя
name string Наименование залогодержателя
birthday string День рождения залогодержателя

Поля в history

Параметр Тип Описание
regDate string Дата действия
type string Тип рег. действия. Возможные значения: CHANGE — изменение, CREATION — создание
Authorizations:
basicAuth
path Parameters
vin_number
required
string
Example: LGWFF7A64SJ631648

Responses

Response samples

Content type
application/json
{
  • "response": {
    }
}

Справочники значений

Ниже приведены перечни фиксированных значений для атрибутов, используемых в системе.

Категории ТС (car_category)

Возможное значение Описание
A Мотоциклы
B Легковые автомобили (с разрешенной максимальной массой до 3,5 тонн и числом сидячих мест, помимо сиденья водителя, не более 8).
C Грузовые автомобили (с разрешенной максимальной массой более 3,5 тонн).
D Автобусы (предназначенные для перевозки пассажиров и имеющие более 8 сидячих мест, помимо сиденья водителя).
O Прицепы (полуприцепы) к легковым и грузовым автомобилям, мотоциклам, мотороллерам и квадрициклам

Тип привода (drive_type)

Возможное значение Описание
Полный Полный привод (4x4, AWD)
Задний Задний привод (RWD)
Передний Передний привод (FWD)
Прочие Другие варианты / нестандартные

Тип топлива (fuel_name)

Возможное значение Описание
Бензин Бензиновый двигатель
Бензин/газ Бензин с газовым оборудованием (ГБО)
Бензин/Е85 Бензин + этанол (E85)
Водород Водородный двигатель / топливные элементы
Газ Метан/пропан-бутан
Дизель Дизельный двигатель
Дизель/газ Комбинированный дизель + газ
Нет Нет данных
Прочие Другие виды топлива

Коробка передач (kpp)

Возможное значение Описание
Механическая Механическая КПП (МКПП)
Автоматическая Автоматическая КПП (АКПП, вариатор, робот и т.п.)
Нет Нет данных
Прочие Другие типы КПП

Руль (steer_side)

Возможное значение Описание
left Левый руль
right Правый руль

Тип собственника ТС (person_type)

Возможное значение Описание
Natural Физическое лицо
Legal Юридическое лицо
Individual entrepreneur Индивидуальный предприниматель

Типы транспортных средств (type)

Код Описание
01 Грузовые автомобили бортовые
02 Грузовые автомобили шасси
03 Грузовые автомобили фургоны
04 Грузовые автомобили тягачи седельные
05 Грузовые автомобили самосвалы
06 Грузовые автомобили рефрижераторы
07 Грузовые автомобили цистерны
08 Грузовые автомобили с гидроманипулятором
09 Грузовые автомобили прочие
21 Легковые автомобили универсал
22 Легковые автомобили комби (хэтчбек)
23 Легковые автомобили седан
24 Легковые автомобили лимузин
25 Легковые автомобили купе
26 Легковые автомобили кабриолет
27 Легковые автомобили фаэтон
28 Легковые автомобили пикап
29 Легковые автомобили прочие
41 Автобусы длиной не более 5 м
42 Автобусы длиной более 5 м, но не более 8 м
43 Автобусы длиной более 8 м, но не более 12 м
44 Автобусы сочлененные длиной более 12 м
49 Автобусы прочие
51 Специализированные автомобили автоцистерны
52 Специализированные автомобили санитарные
53 Специализированные автомобили автокраны
54 Специализированные автомобили заправщики
55 Специализированные автомобили мастерские
56 Специализированные автомобили автопогрузчики
57 Специализированные автомобили эвакуаторы
58 Специализированные пассажирские транспортные средства
59 Специализированные автомобили прочие
71 Мотоциклы
72 Мотороллеры и мотоколяски
73 Мотовелосипеды и мопеды
74 Мотонарты
80 Прицепы самосвалы
81 Прицепы к легковым автомобилям
82 Прицепы общего назначения к грузовым автомобилям
83 Прицепы цистерны
84 Прицепы тракторные
85 Прицепы вагоны-дома передвижные
86 Прицепы со специализированными кузовами
87 Прицепы трейлеры
88 Прицепы автобуса
89 Прицепы прочие
91 Полуприцепы с бортовой платформой
92 Полуприцепы самосвалы
93 Полуприцепы фургоны
95 Полуприцепы цистерны
99 Полуприцепы прочие
31 Трактора
32 Самоходные машины и механизмы
33 Трамваи
34 Троллейбусы
35 Велосипеды
36 Гужевой транспорт
38 Подвижной состав железных дорог
39 Иной

Цели и основания регистрации ТС (last_operation)

Код Описание
01 регистрация новых, произведенных в России или ввезенных, а также ввезенных в Россию бывших в эксплуатации, в том числе временно на срок более 6 месяцев, испытательной техники
02 регистрация ранее зарегистрированных в регистрирующих органах
03 изменение собственника (владельца) в результате совершения сделки, вступления в наследство, слияние и разделение капитала у юридического лица, переход права по договору лизинга, судебные решения и др.
04 изменение данных о собственнике (владельце)
05 изменение данных о транспортном средстве, в том числе изменение технических характеристик и (или) назначения (типа) транспортного средства
06 выдача взамен утраченных или пришедших в негодность государственных регистрационных знаков, регистрационных документов, паспортов транспортных средств.
07 прекращение регистрации в том числе
08 снятие с учета в связи с убытием за пределы Российской Федерации
09 снятие с учета в связи с утилизацией
11 первичная регистрация
12 регистрация снятых с учета
13 временная регистрация ТС (на срок проведения проверок, на срок временной прописки, регистрация испытательной техники)
14 временный учет (временная регистрация места пребывания ТС без выдачи документов)
15 регистрация ТС, ввезенных из-за пределов Российской Федерации
16 регистрация ТС, прибывших из других регионов Российской Федерации
17 регистрация ТС по новому месту жительства собственника, прибывшего из другого субъекта Российской Федерации, с одновременным снятием с учета по прежнему месту жительства
18 восстановление регистрации после аннулирования
41 замена государственного регистрационного знака
42 выдача дубликата регистрационного документа
43 выдача (замена) паспорта ТС
44 замена номерного агрегата, цвета, изменение конструкции ТС
45 изменение Ф.И.О. (наименования) владельца
46 изменение места жительства (юридического адреса) владельца в пределах территории обслуживания регистрационным пунктом
47 наличие запретов и ограничений
48 снятие запретов и ограничений
49 регистрация залога ТС
50 прекращение регистрации залога ТС
51 коррекция иных реквизитов
52 выдача акта технического осмотра
53 проведение ГТО
54 постоянная регистрация ТС по окончанию временной
55 коррекция реквизитов по информации налоговых органов
56 коррекция реквизитов при проведении ГТО
61 в связи с изменением места регистрации
62 в связи с прекращением права собственности (отчуждение, конфискация ТС)
63 в связи с вывозом ТС за пределы Российской Федерации
64 в связи с окончанием срока временной регистрации
65 в связи с утилизацией
66 в связи с признанием регистрации недействительной
67 снятие с временного учета
68 снятие с учета в связи с кражей или угоном
69 постановка с одновременным снятием с учета
81 документов в связи с обнаружением
82 удаление ошибочно введенной записи
83 удаление в связи со сверкой
84 перевод в архив в связи с корректировкой
91 по наследству с заменой государственных регистрационных знаков
92 по наследству с сохранением государственных регистрационных знаков за новым собственником (наследником)
93 по сделкам, произведенным в любой форме (купля-продажа, дарение, др.) с заменой государственных регистрационных знаков
94 по сделкам, произведенным в любой форме (купля-продажа, дарение, др.) с сохранением государственных регистрационных знаков за новым собственником

Типы ограничений

Ограничения в БАД-АПИ можно получить методом restricted.

Тип инициатора ограничений используется на странице источника (ГИБДД), при запросе ограничений.

Код (ogrkod) Наименование
0
1 Запрет на регистрационные действия
2 Запрет на снятие с учета
3 Запрет на регистрационные действия и прохождение ГТО
4 Утилизация (для транспорта не старше 5 лет)
5 Аннулирование

Типы инициаторов ограничений

Ограничения в БАД-АПИ можно получить методом restricted.

Тип инициатора ограничений используется на странице источника (ГИБДД), при запросе ограничений.

Идентификатор типа передается в поле divtype источника (и метода restricted).

Код (divtype) Наименование
0 не предусмотренный код
1 Судебные органы
2 Судебный пристав
3 Таможенные органы
4 Органы социальной защиты
5 Нотариус
6 ОВД или иные правоохр. органы
7 ОВД или иные правоохр. органы (прочие)

Состояния исполнения постановления водительского удостоверения

Состояние постановления (поле state)

При получении данных по водительскому удостоверению методом vu в блоке decis возвращается поле state. Это код состояния исполнения постановления. Для отображения используется встроенный справочник:

Код (state) Значение
42 Вынесено постановление о лишении права управления ТС
60 Постановление о лишении права управления ТС вступило в законную силу
68 Исчисление срока лишения права управления ТС прервано
71 Прекращение исполнения постановления
73 Поступление информации об уплате штрафа
76 Поступление информации об уплате штрафа (от банка)
78 Начато исчисление срока лишения права управления
79 Окончено исчисление срока лишения права управления
82 Проведение проверки знаний ПДД