Главная → Документация → Проверка ДТП
Проверка ДТП по VIN
Записи о дорожно-транспортных происшествиях из архивов проверок: дата и тип ДТП, регион и место, повреждения, официальные и неофициальные источники. Важно: данные архивные, не в реальном времени — каждый ответ содержит пометку об этом и дату проверки источником.
Аутентификация
Единый API-токен для всех API выдаётся сразу после регистрации в личном кабинете. Передавайте его в заголовке:
Authorization: Bearer ВАШ_ТОКЕН
Эндпоинт
GET https://api.avtovincod.ru/accidents?vin=Z8TND5FS9DM023825
Authorization: Bearer ВАШ_ТОКЕН
| Параметр | Описание |
|---|---|
| vin | VIN, строго 17 символов (латиница без I, O, Q). Кириллические двойники нормализуются автоматически. |
| force_refresh=1 | Необязательный. Игнорировать кэш и свежесть архива — принудительный запрос к источнику. |
Пример успешного ответа
{
"success": 1,
"query": { "vin": "Z8TND5FS9DM023825" },
"archival": true,
"dataNote": "Архивные данные (кэш источника), не в реальном времени.",
"checkedAt": "2026-04-07 02:11:27",
"hasAccidents": true,
"found": 2,
"records": [
{
"date": "2020-12-24", "number": "220037998", "type": "Столкновение",
"region": "Нижегородская область", "place": "Нижний Новгород, Нижегородская область, ПФО",
"brand": "CITROEN", "model": "C4",
"damageState": "Повреждено", "damagePoints": ["118", "119", "120", "121", "122"],
"damageDescription": null, "vehiclesInvolved": 2,
"department": null, "damage": null, "source": "official"
},
{
"date": "2015-09-04", "number": null, "type": "Столкновение",
"region": "г. Москва", "place": null, "brand": null, "model": null,
"damageState": null, "damagePoints": null, "damageDescription": null,
"vehiclesInvolved": null, "department": "ЮАО ПОЛК ДПС",
"damage": "зад слева", "source": "unofficial"
}
]
}
Поле source у записи: official — официальные данные, unofficial — неофициальные (показаны отдельным признаком). number — номер ДТП (если известен), damagePoints — коды точек повреждений, checkedAt — когда источник реально проверял VIN. Если VIN ещё не проверялся источником, придёт success: 1 с notInArchive: true — такой запрос не тарифицируется.
Коды ошибок
| HTTP · code | Что означает |
|---|---|
| 400 · BAD_VIN | Неверный формат VIN (нужно строго 17 символов). |
| 400 · INPUT_REQUIRED | VIN не указан. |
| 403 · NOT_ALLOWED / API_DISABLED | API не подключён для токена или временно отключён. |
| 401 · NO_TOKEN / TOKEN_INVALID | Токен не передан, неверен или деактивирован. |
| 402 · INSUFFICIENT_BALANCE | Недостаточно средств. Пополните баланс в кабинете. |
| 403 · IP_NOT_ALLOWED | IP не входит в ваш белый список (если он настроен). |
| 429 · RATE_LIMIT / RATE_LIMIT_IP | Превышена частота запросов в минуту. |
| 200 · PROVIDER_FAIL (success: 0) | Источник не смог выполнить проверку. Не тарифицируется. |
| 503 · SERVICE_UNAVAILABLE | Источник временно недоступен. Не тарифицируется. |
Пример на cURL
curl -s --max-time 60 "https://api.avtovincod.ru/accidents?vin=Z8TND5FS9DM023825" \
-H "Authorization: Bearer ВАШ_ТОКЕН"
Тарификация
Списание происходит, когда проверка найдена в архивах источника (success: 1) — в том числе если ДТП по автомобилю не зафиксированы (hasAccidents: false). Если данных по VIN в архивах нет (notInArchive: true) — запрос бесплатный. Ошибки и недоступность источника не тарифицируются. Актуальная цена, баланс и статистика — в личном кабинете.
Попробуйте прямо сейчас. Регистрация за минуту, токен сразу, пополнение картой от 100 ₽. Проверить можно и без кода: в кабинете есть консоль проверки.
Создать аккаунт