Главная → Документация → Полисы ОСАГО

Полисы ОСАГО

Действующие и прошлые полисы ОСАГО автомобиля: страховая компания, серия и номер полиса, статус, срок действия, марка и модель. Поиск по VIN, госномеру, номеру кузова или по серии и номеру самого полиса.

Хост api.avtovincod.ru Метод GET Формат JSON Авторизация Bearer Ответ до 3 мин

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

Единый API-токен для всех API выдаётся сразу после регистрации в личном кабинете. Передавайте его в заголовке:

Authorization: Bearer ВАШ_ТОКЕН

Эндпоинт

GET https://api.avtovincod.ru/osago?vin=XTA210740A2861234
Authorization: Bearer ВАШ_ТОКЕН

Способ поиска указывается ровно один: vin, plate, body или пара series+number.

Параметр	Описание
vin	VIN, от 11 до 17 символов (латиница без I, O, Q; кириллица нормализуется).
plate	Госномер, от 6 до 9 символов (буквы АВЕКМНОРСТУХ и цифры). Синоним: regNumber.
body	Номер кузова, от 4 до 25 символов. Синоним: bodyNumber.
series, number	Серия (например ТТТ или ХХХ) и номер полиса - поиск по самому полису.
date	Необязательный, ГГГГ-ММ-ДД: дата, на которую ищется полис (по умолчанию - сегодня).
force_refresh=1	Необязательный. Игнорировать кэш.

Пример успешного ответа

{
  "success": 1,
  "query": { "vin": "XTA210740A2861234" },
  "found": 1,
  "policies": [
    {
      "companyName": "СТРАХОВАЯ КОМПАНИЯ «ПРИМЕР»",
      "policySerial": "ТТТ",
      "policyNumber": "7089126075",
      "vin": "XTA210740A2861234",
      "vin_mask": null,
      "bodyNumber": null,
      "bodyNumber_mask": null,
      "chassisNumber": null,
      "chassisNumber_mask": null,
      "licensePlate": "А123АА77",
      "licensePlate_mask": null,
      "regNumber": "А123АА77",
      "regNumber_mask": null,
      "markmodel": "LADA 210740",
      "status": "Действует",
      "startDate": "2026-02-11",
      "endDate": "2027-02-10"
    }
  ]
}

Все 17 полей полиса присутствуют всегда: если источник поле не знает - придёт null. Поля с суффиксом _mask - маскированные варианты идентификаторов (например М9***Н71), когда источник скрывает полное значение. Персональные данные страхователей и служебные поля источников в ответ не попадают.

Проверка опрашивает до трёх независимых источников по очереди; один из них решает капчу, поэтому ответ может занимать 2-3 минуты. Закладывайте таймаут клиента 180 секунд и не разрывайте соединение раньше.

Коды ошибок

HTTP · code	Что означает
400 · VIN_INVALID / PLATE_INVALID / BODY_INVALID	Неверный формат идентификатора.
400 · INPUT_REQUIRED	Не указан ни один способ поиска (vin, plate, body или series+number).
401 · NO_TOKEN / TOKEN_INVALID	Токен не передан, неверен или деактивирован. Возьмите актуальный в кабинете.
402 · INSUFFICIENT_BALANCE	Недостаточно средств. Пополните баланс в кабинете (раздел «Платежи»).
403 · NOT_ALLOWED / API_DISABLED	API не подключён для токена или временно отключён. Запросите доступ в кабинете.
403 · IP_NOT_ALLOWED	IP не входит в ваш белый список (если он настроен).
429 · RATE_LIMIT / RATE_LIMIT_IP	Превышена частота запросов в минуту. Повторите через минуту.
503 · PROVIDER_FAIL / SERVICE_UNAVAILABLE	Источники временно недоступны. Повторите позже, запрос не тарифицирован.

Пример на cURL

curl -s --max-time 180 "https://api.avtovincod.ru/osago?plate=А123АА77" \\
  -H "Authorization: Bearer ВАШ_ТОКЕН"

Тарификация

Списание происходит, когда проверка выполнена (success: 1), даже если полисов не найдено (found: 0 - это тоже результат проверки). Ошибки, недоступность источников и повторы из кэша не тарифицируются. Актуальная цена и баланс доступны в личном кабинете.

Попробуйте прямо сейчас. Регистрация за минуту, токен сразу, пополнение картой от 100 ₽. Проверить можно и без кода: в кабинете есть консоль проверки.

Создать аккаунт