Главная → Документация → Проверка такси

Проверка разрешения такси

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

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

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

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

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

Эндпоинт

GET https://api.avtovincod.ru/taxi?plate=А123АА777
Authorization: Bearer ВАШ_ТОКЕН

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

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

{
  "success": 1,
  "query": { "regNumber": "А123АА777" },
  "isTaxi": true,
  "found": 1,
  "records": [
    {
      "vin": "XW8ZZZ1KZLG012345",
      "regNumber": "А123АА777",
      "regionName": "Москва",
      "permitNumber": 123456,
      "carLabel": "SKODA OCTAVIA",
      "year": 2019,
      "color": "Белый",
      "dateFrom": "2021-05-14",
      "dateTo": "2026-05-14",
      "dateFgisAdded": "2021-05-15",
      "isLiftingDevice": 0,
      "isActual": 1,
      "source": "fgis",
      "carriers": []
    }
  ]
}

Поле isTaxi равно true, если есть хотя бы одно действующее разрешение (isActual: 1). Пустой список records при success: 1 означает, что проверка выполнена и разрешений не найдено. Страховки ОСАГО в ответе не отдаются.

Коды ошибок

HTTP · code	Что означает
400 · VIN_INVALID / PLATE_INVALID	Неверный формат VIN или госномера.
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	Превышена частота запросов в минуту. Повторите через минуту.
503 · SERVICE_UNAVAILABLE	Источник временно недоступен. Повторите позже, запрос не тарифицирован.

Пример на cURL

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

Тарификация

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

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

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