Главная → Документация → Проверка штрафов
Проверка штрафов ГИБДД
Проверка штрафов ГИБДД по номеру СТС, водительскому удостоверению или номеру постановления. По каждому штрафу возвращаются сумма, дата, подразделение, наличие и срок действия скидки, статус оплаты.
Аутентификация
Единый API-токен для всех API выдаётся сразу после регистрации в личном кабинете. Передавайте его в заголовке:
Authorization: Bearer ВАШ_ТОКЕН
Эндпоинт
GET https://api.avtovincod.ru/fines?sts=5058794047
Authorization: Bearer ВАШ_ТОКЕН
| Параметр | Описание |
|---|---|
| sts | Номер СТС (свидетельства о регистрации ТС), от 8 до 12 символов. |
| driverLicense | Номер водительского удостоверения, 10 цифр (серия 4 + номер 6). Синоним: dl. |
| numPost | Номер постановления (УИН), от 15 до 30 цифр. Синоним: uin. |
| force_refresh=1 | Необязательный. Игнорировать кэш. |
Пример успешного ответа
{
"success": 1,
"query": { "sts": "5058794047" },
"found": 1,
"unpaid": 1,
"total_sum": 500,
"fines": [
{
"num_post": "18810150260211001234",
"sum": 500,
"date_post": "2026-02-11",
"division_name": "ЦАФАП ГИБДД ГУ МВД",
"enable_discount": true,
"date_discount": "2026-02-26",
"paid": null
}
]
}
По номеру СТС и водительскому удостоверению возвращаются только неоплаченные постановления, поэтому поле paid равно null. Статус оплаты (true или false) доступен только при поиске по номеру постановления. Поля unpaid и total_sum - это количество и суммарный размер неоплаченных штрафов в рублях.
Коды ошибок
| HTTP · code | Что означает |
|---|---|
| 400 · STS_INVALID / DL_INVALID / UIN_INVALID | Неверный формат СТС, ВУ или номера постановления. |
| 400 · INPUT_REQUIRED | Не указан ни один из параметров поиска. |
| 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/fines?sts=5058794047" \\
-H "Authorization: Bearer ВАШ_ТОКЕН"
Тарификация
Списание происходит, когда проверка выполнена (success: 1), даже если штрафов нет. Ошибки, недоступность источника и повторы из кэша не тарифицируются. Актуальная цена и баланс доступны в личном кабинете.
Попробуйте прямо сейчас. Регистрация за минуту, токен сразу, пополнение картой от 100 ₽. Проверить можно и без кода: в кабинете есть консоль проверки.
Создать аккаунт