driver_license — Проверка водительского удостоверения¶
POST https://api.newdb.net/v2
Проверяет водительское удостоверение (ВУ) РФ по номеру, серии, ФИО и дате рождения через официальный сервис Госуслуг и базу данных ГИБДД МВД РФ.
Раздел: Физические лица
Связанные страницы¶
- Обзор раздела физические лица
- passport_mvd — Проверка паспорта РФ на действительность
- vin_check — Проверка автомобиля по VIN (Госуслуги)
- complex_by_passport — Комплексная проверка по данным паспорта
Когда использовать¶
- Проверка подлинности и действительности водительского удостоверения соискателя при найме водителей, курьеров, экспедиторов.
- Скоринг и комплаенс-проверка клиентов в сервисах каршеринга, автопроката и таксопарках.
- Проверка наличия судебных решений о лишении права управления транспортными средствами.
- Определение категорий транспортных средств (
B,C,D,CEи др.) и водительского стажа.
Заголовки¶
Content-Type: application/json
X-API-KEY: <your_token>
Параметры запроса¶
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
num |
string | Да | Серия и номер водительского удостоверения (10 символов, например 9901123456 или 99 01 123456). Поддерживается также алиас driver_license. |
lastname |
string | Да | Фамилия владельца ВУ (на русском языке, например Иванов). |
firstname |
string | Да | Имя владельца ВУ (на русском языке, например Иван). |
birthdate |
string | Да | Дата рождения водителя в формате YYYY-MM-DD (1990-01-01) или DD.MM.YYYY (01.01.1990). Поддерживается также алиас dob. |
secondname |
string | Нет | Отчество владельца ВУ (при наличии). Опционально. |
method |
string | Да | Значение driver_license. |
country |
string | Нет | Код страны, по умолчанию ru. |
get_screen |
integer | Нет | 1 — сохранить скриншот страницы с результатом проверки, 0 — без скриншота (по умолчанию). |
Входная схема (request)¶
{
"params": {
"num": "99 01 123456",
"lastname": "Иванов",
"firstname": "Иван",
"secondname": "Иванович",
"birthdate": "1990-01-01",
"method": "driver_license",
"country": "ru"
},
"webhook": "https://your.host/whook",
"requestId": "00000000-0000-4000-8000-000000000001"
}
Пример запроса¶
POST /v2 HTTP/1.1
Host: api.newdb.net
Content-Type: application/json
X-API-KEY: YOUR_TOKEN
{
"params": {
"num": "99 01 123456",
"lastname": "Иванов",
"firstname": "Иван",
"secondname": "Иванович",
"birthdate": "01.01.1990",
"method": "driver_license",
"country": "ru",
"get_screen": 0
},
"webhook": "https://your.host/whook",
"requestId": "00000000-0000-4000-8000-000000000001"
}
Пример ответа (удостоверение найдено)¶
{
"params": {
"num": "99 01 123456",
"lastname": "Иванов",
"firstname": "Иван",
"secondname": "Иванович",
"birthdate": "1990-01-01",
"method": "driver_license"
},
"requestId": "00000000-0000-4000-8000-000000000001",
"state": "complete",
"status": "success",
"results": {
"driver_license": {
"taskId": "00000000-0000-4000-8000-000000000002",
"dateupdated": "2026-09-17 12:00:00",
"result": {
"status": 200,
"found": true,
"data": [
{
"num": "99 01 123456",
"status": "Действует",
"is_valid": true,
"is_deprived": false,
"issue_date": "15.05.2020",
"expire_date": "15.05.2030",
"categories": [
"B",
"B1",
"M"
],
"experience_from": "2008",
"birth_place": "Г. МОСКВА",
"deprivation": null,
"special_notes": null,
"applicant": {
"lastname": "Иванов",
"firstname": "Иван",
"secondname": "Иванович",
"birthdate": "01.01.1990"
}
}
],
"message": "Сведения о водительском удостоверении успешно получены"
}
}
}
}
Пример ответа (удостоверение не найдено)¶
Если в базе данных ГИБДД отсутствуют записи с переданными параметрами, возвращается HTTP 200 со статусом found: false и пустым массивом data:
{
"state": "complete",
"status": "success",
"results": {
"driver_license": {
"result": {
"status": 200,
"found": false,
"data": [],
"message": "Водительское удостоверение с указанными входными параметрами не найдено"
}
}
}
}
Поля объекта записи в data¶
| Поле | Тип | Описание |
|---|---|---|
num |
string | Серия и номер удостоверения в читаемом формате (99 01 123456). |
status |
string | Текущий статус документа («Действует», «Лишен права управления», «Недействительно»). |
is_valid |
boolean | Флаг действительности удостоверения (true — действительно и нет лишения). |
is_deprived |
boolean | Флаг лишения права управления (true — водитель лишен прав). |
issue_date |
string | Дата выдачи удостоверения. |
expire_date |
string | Дата окончания срока действия документа. |
categories |
array | Список открытых категорий транспортных средств (["B", "B1", "M"]). |
experience_from |
string | Год начала водительского стажа (например "2008"). |
birth_place |
string | Место рождения водителя по данным ГИБДД. |
deprivation |
object | null | Детали судебного постановления о лишении прав (дата, срок, состояние исполнения) при наличии. |
special_notes |
string | null | Особые отметки водителя (ограничения по зрению, автоматическая трансмиссия AT и др.). |
AI Summary¶
Компактные метаданные для AI и агентных систем
{
"method": "driver_license",
"intent": "Проверка водительского удостоверения РФ через сервис Госуслуг и ГИБДД",
"endpoint": "POST https://api.newdb.net/v2",
"required_headers": ["X-API-KEY"],
"required_fields": ["num", "lastname", "firstname", "birthdate", "method"],
"aliases": {
"num": ["driver_license", "vu_number", "number"],
"birthdate": ["dob"]
},
"returns": ["results.driver_license.result.status", "results.driver_license.result.found", "results.driver_license.result.data"]
}