Главная → Документация → История госномеров авто по VIN и номеру кузова

История госномеров авто по VIN и номеру кузова

История госномеров авто по VIN и номеру кузова: какие номера были у автомобиля, списком от последнего к первому. Платно, только если найдено больше одного разного номера; один номер или ни одного: бесплатно. Только номера, без дат, СТС и персональных данных. Ответ за доли секунды.

Метод GET /plate-historyПоиск VIN или номер кузоваПлатно только от 2 номеровОтвет доли секунды

Зачем знать прежние госномера машины

Перед покупкой. Сколько раз меняли номер: частая смена бывает у перепродаваемых машин, такси и автомобилей после ДТП.
Поиск по старым данным. По прежним номерам находятся штрафы, ДТП, объявления о продаже и фотографии, которые были оформлены на них.
Сверка документов. Номер из старого договора, полиса или объявления действительно принадлежал этой машине.

Как узнать историю госномеров по VIN или номеру кузова

По VIN: ?vin=XTA217030B0325205. Русские буквы-двойники переводятся в латиницу автоматически.
По номеру кузова: ?body=WDB2110611X103579, для машин без VIN, например праворульных японских.
Без программирования: консоль проверки в личном кабинете, вкладки "По VIN" и "По кузову".

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

Токен передаётся заголовком Authorization: Bearer <токен> либо параметром ?token=. Токен один для всех API, он выдаётся в личном кабинете сразу после регистрации.

Эндпоинт

GET https://api.avtovincod.ru/plate-history

Параметры

Параметр	Описание	Обязателен
`vin`	VIN, 17 символов	да*
`body`	номер кузова, 6-17 символов, с дефисом или без	да*

* Ровно один из параметров vin и body. Ничего не передано: INPUT_REQUIRED, оба: INPUT_CONFLICT.

Пример запроса

curl --max-time 30 -H "Authorization: Bearer $TOKEN" \
  "https://api.avtovincod.ru/plate-history?vin=XTA217030B0325205"

curl --max-time 30 -H "Authorization: Bearer $TOKEN" \
  "https://api.avtovincod.ru/plate-history?body=WDB2110611X103579"

Пример ответа: история найдена

{
  "success": 1,
  "query": { "vin": "XTA217030B0325205" },
  "found": 3,
  "plates": ["В531УМ750", "В531УК750", "Т891РТ190"]
}

Первым идёт последний номер. Проверка платная: найдено больше одного номера.

Поля ответа

Поле	Значение
`query`	что искали после нормализации: { "vin" } или { "body" }
`found`	число номеров в plates: 2 и больше значит история найдена (платно), 0 значит не найдена (бесплатно)
`plates[]`	госномера от последнего к первому, кириллицей, без пробелов; без дат и других полей

Значение found не бывает равным 1: один номер это не история, он не показывается и не тарифицируется.

Пример ответа: история не найдена

У машины в базе один номер или ни одного. Ответ успешный, но бесплатный, номер не показывается:

{
  "success": 1,
  "query": { "vin": "XUUNF197JAC005343" },
  "found": 0,
  "plates": []
}

Поиск по номеру кузова

Сначала находится автомобиль, у которого записан этот кузов, затем вся история его номеров. Если такой кузов записан у нескольких разных машин (бывает у коротких номеров кузова), определить автомобиль однозначно нельзя: ответ found: 0, бесплатно. Повторите поиск по VIN.

Коды ошибок

Код	Значение
`NO_TOKEN`	токен не передан
`TOKEN_INVALID`	токен недействителен или деактивирован
`NOT_ALLOWED`	API не подключён вашему токену
`API_DISABLED`	API временно отключён
`IP_NOT_ALLOWED`	запрос с IP вне вашего белого списка
`INPUT_REQUIRED`	не передан ни vin, ни body
`INPUT_CONFLICT`	переданы оба параметра
`BAD_VIN`	VIN не 17 символов либо содержит недопустимые знаки
`BAD_BODY`	номер кузова короче 6 или длиннее 17 символов
`INSUFFICIENT_BALANCE`	недостаточно средств на балансе
`RATE_LIMIT`	превышен лимит запросов в минуту
`RATE_LIMIT_IP`	слишком много запросов с одного IP
`SERVICE_UNAVAILABLE`	сервис временно недоступен, повторите позже
`PROVIDER_FAIL`	источник не ответил, повторите позже

Ошибка приходит в виде {"success": 0, "error": "...", "code": "..."} и никогда не тарифицируется. PROVIDER_FAIL приходит с HTTP 200: проверяйте поле success.

Примеры кода: PHP, Python, JavaScript, Go, Java, C#, Ruby, 1С

Примеры готовы к запуску: токен берётся из переменной окружения AVC_TOKEN, а в запросе стоит тестовое значение (vin=X7TEST00000000001). По тестовым значениям приходит ответ-образец по схеме метода: бесплатно, без списания и даже при нулевом балансе, с полем "testMode": true. Так интеграцию можно собрать и проверить до первого платного запроса. Все тестовые значения.

cURLPHPPythonJavaScriptGoJavaC#Ruby1С

curl -s --max-time 30 -G "https://api.avtovincod.ru/plate-history" \
  --data-urlencode "vin=X7TEST00000000001" \
  -H "Authorization: Bearer $AVC_TOKEN"

<?php
$url = 'https://api.avtovincod.ru/plate-history?' . http_build_query(['vin' => 'X7TEST00000000001']);
$ch  = curl_init($url);
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('AVC_TOKEN')]]);
$d = json_decode(curl_exec($ch), true);
echo $d['success'] ? json_encode($d, JSON_UNESCAPED_UNICODE) : $d['code'] . ': ' . $d['error'];

import os, requests

r = requests.get("https://api.avtovincod.ru/plate-history", params={"vin": "X7TEST00000000001"},
                 headers={"Authorization": "Bearer " + os.environ["AVC_TOKEN"]}, timeout=30)
d = r.json()
print(d if d.get("success") else f'{d["code"]}: {d["error"]}')

// Node.js 18+, файл .mjs (await на верхнем уровне)
const url = "https://api.avtovincod.ru/plate-history?" + new URLSearchParams({ vin: "X7TEST00000000001" });
const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.AVC_TOKEN}` },
                               signal: AbortSignal.timeout(30000) });
const d = await res.json();
console.log(d.success ? d : `${d.code}: ${d.error}`);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
	"os"
	"time"
)

func main() {
	q := url.Values{}
	q.Set("vin", "X7TEST00000000001")
	req, _ := http.NewRequest("GET", "https://api.avtovincod.ru/plate-history?"+q.Encode(), nil)
	req.Header.Set("Authorization", "Bearer "+os.Getenv("AVC_TOKEN"))
	resp, err := (&http.Client{Timeout: 30 * time.Second}).Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(resp.StatusCode, string(body))
}

// Java 11+
import java.net.URI;
import java.net.URLEncoder;
import java.net.http.*;
import java.nio.charset.StandardCharsets;
import java.time.Duration;

public class AvtoVinCod {
    public static void main(String[] args) throws Exception {
        String q = "vin=" + URLEncoder.encode("X7TEST00000000001", StandardCharsets.UTF_8);
        HttpRequest req = HttpRequest.newBuilder(URI.create("https://api.avtovincod.ru/plate-history?" + q))
            .header("Authorization", "Bearer " + System.getenv("AVC_TOKEN"))
            .timeout(Duration.ofSeconds(30)).GET().build();
        HttpResponse<String> resp = HttpClient.newHttpClient()
            .send(req, HttpResponse.BodyHandlers.ofString());
        System.out.println(resp.statusCode() + " " + resp.body());
    }
}

// .NET 6+
using System.Net.Http.Headers;

using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
http.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("AVC_TOKEN"));
var url = "https://api.avtovincod.ru/plate-history?" + "vin=" + Uri.EscapeDataString("X7TEST00000000001");
var resp = await http.GetAsync(url);
Console.WriteLine((int)resp.StatusCode + " " + await resp.Content.ReadAsStringAsync());

require "net/http"
require "json"

uri = URI("https://api.avtovincod.ru/plate-history")
uri.query = URI.encode_www_form(vin: "X7TEST00000000001")
req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer #{ENV["AVC_TOKEN"]}"
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true, read_timeout: 30) { |h| h.request(req) }
d = JSON.parse(res.body)
puts d["success"] == 1 ? d : "#{d["code"]}: #{d["error"]}"

Токен = "ВАШ_ТОКЕН";
Соединение = Новый HTTPСоединение("api.avtovincod.ru", 443, , , , 30, Новый ЗащищенноеСоединениеOpenSSL);
Запрос = Новый HTTPЗапрос("/plate-history?" + "vin=" + КодироватьСтроку("X7TEST00000000001", СпособКодированияСтроки.КодировкаURL));
Запрос.Заголовки.Вставить("Authorization", "Bearer " + Токен);
Ответ = Соединение.Получить(Запрос);

Чтение = Новый ЧтениеJSON;
Чтение.УстановитьСтроку(Ответ.ПолучитьТелоКакСтроку("UTF-8"));
Данные = ПрочитатьJSON(Чтение);
Чтение.Закрыть();

Если Данные.success = 1 Тогда
    Сообщить("Проверка выполнена");
Иначе
    Сообщить(Данные.code + ": " + Данные.error);
КонецЕсли;

Бесплатных тестовых периодов и долгих согласований нет: пополните баланс в личном кабинете и сразу проверяйте реальные машины. Токен выдаётся при регистрации, деньги списываются только по правилам метода (раздел "Тарификация"). Нужен доступ из ИИ-ассистента: MCP-сервер.

Примеры ответов: успешный, ошибка, источник недоступен

Успешный запрос

GET https://api.avtovincod.ru/plate-history?vin=XTAGFL110MY463366
Authorization: Bearer ВАШ_ТОКЕН

HTTP 200, success: 1. Списание по тарифу метода, сумма и остаток в блоке billing (цифры в примере условные).

{
  "success": 1,
  "query": {
    "vin": "XTAGFL110MY463366"
  },
  "found": 2,
  "plates": [
    "А123ВС777",
    ...
  ],
  "billing": {
    "charged": 0.5,
    "currency": "RUB",
    "billed": true,
    "balance": 999.5,
    "requestId": 1234567
  }
}

Бесплатная проба без списания: https://api.avtovincod.ru/plate-history?vin=X7TEST00000000001 вернёт ответ-образец по этой же схеме с полем testMode: true и charged: 0.

Неуспешный запрос

GET https://api.avtovincod.ru/plate-history?vin=XTAGFL110MY46336
Authorization: Bearer ВАШ_ТОКЕН

Ошибка в параметрах: HTTP 400, код BAD_VIN, текст ошибки можно показать пользователю. Бесплатно.

{
  "success": 0,
  "error": "VIN должен содержать 17 символов, у вас 16. Проверьте ввод.",
  "code": "BAD_VIN"
}

Источник недоступен

GET https://api.avtovincod.ru/plate-history?vin=XTAGFL110MY463366
Authorization: Bearer ВАШ_ТОКЕН

Источник временно недоступен: HTTP 503, SERVICE_UNAVAILABLE. Бесплатно, повторите запрос позже. Запрос записан в историю с charged: 0.

{
  "success": 0,
  "error": "Сервис временно недоступен",
  "code": "SERVICE_UNAVAILABLE",
  "billing": {
    "charged": 0,
    "currency": "RUB",
    "billed": false,
    "balance": 999.5,
    "requestId": 1234569
  }
}

Тарификация

Списание только когда найдено больше одного разного номера (found 2 и больше). Один номер, ни одного, неоднозначный кузов и все ошибки бесплатны. Цена и подключение метода в личном кабинете.

В ответ добавляется блок billing: сколько списано за этот запрос (charged, в рублях), платный ли он (billed), остаток баланса после запроса (balance) и номер в истории запросов (requestId). Те же данные в заголовках X-Charged, X-Balance, X-Request-Id. Нет блока - запрос не списан. Подробнее о блоке billing.

Уже подключены? Ничего менять не нужно.

Прежние поля ответа, коды ошибок, HTTP-статусы и правила списания остались как были. Интеграции, настроенные раньше, работают без изменений.
Новое только одно: в конец JSON добавлен блок billing, а в ответ пришли заголовки X-Charged, X-Balance, X-Request-Id. Использовать их не обязательно.
Если ваш код строго проверяет состав полей ответа (например, схема с запретом лишних полей), разрешите поле billing.

MCP-сервер для ИИ-ассистентов

Подключите проверки к ИИ-ассистенту: Claude, Cursor, VS Code и другим клиентам с поддержкой MCP (Model Context Protocol). Ассистент сам вызывает нужный метод по вашему токену, и проверку можно запросить обычными словами: "проверь залог и ограничения по VIN", "есть ли штрафы по СТС". Удобно менеджерам автосалона, лизинга и страховой без программиста, а разработчику помогает быстро собрать прототип интеграции.

Адрес сервера: https://api.avtovincod.ru/mcp, авторизация тем же токеном (Authorization: Bearer ВАШ_ТОКЕН).
Этот метод в MCP - инструмент plate_history; всего инструментов 43.
Цены и списания как у API, в результате тоже есть блок billing. Тестовые значения работают бесплатно.
Инструкция по подключению: avtovincod.ru/docs/mcp/

Для генераторов клиентов и ИИ-агентов: OpenAPI-спецификация метода (YAML). Все методы сразу: /openapi.yaml.

Смежные методы

Госномер по VIN: действующий номер, марка, модель и год.
VIN по госномеру: обратный поиск, VIN и кузов по номеру.
Объявления о продаже и Фотографии автомобиля: ищите по прежним номерам.
История регистрации: периоды владения.

Частые вопросы

Как узнать, какие госномера были у машины?

Отправьте GET-запрос https://api.avtovincod.ru/plate-history?vin=VIN с токеном или введите VIN в консоли проверки в личном кабинете. В ответе список номеров от последнего к первому.

Можно ли узнать историю номеров по номеру кузова?

Да: ?body=НОМЕР_КУЗОВА. Это удобно для машин без VIN, например праворульных японских. Если кузов записан у нескольких разных машин, ответ found: 0 без списания, повторите поиск по VIN.

Почему единственный номер не показывается?

История номеров это смена номера. Если у машины в базе один номер, истории нет: ответ found: 0, проверка бесплатна. Действующий номер по VIN отдаёт метод "Госномер по VIN".

Есть ли в ответе даты смены номеров?

Нет. Ответ это только список госномеров от последнего к первому, без дат, СТС и персональных данных.

Когда списываются деньги?

Только если найдено больше одного разного номера. Один номер, ни одного, неоднозначный кузов и ошибки бесплатны.

Проверить без программиста

В личном кабинете есть консоль проверки: введите номер и получите ответ в читаемом виде, без кода.

Открыть кабинет