API. База ГАИ 2024

Форма для получения API ключа

Каждый может получить бесплатный API-ключ на 1000 запросов в месяц. Если вам нужно более 1000 запросов, свяжитесь с нами для получения премиум-подписки. Преимущества премиум-подписки:

значительно увеличенный лимит запросов
расширенная информация по номерам: VIN-коды, тип операции (первичная / вторичная / другое)
доступ к данным каталога автомобилей, техническим спецификациям авто
техническая поддержка по email и в чатах на ваш выбор
уведомления от нас перед изменениями API

По запросу можем в API добавить необходимый endpoint или данные в удобном для вас формате.

API

Вышла новая версия API (20.11.2022)
Некоторые поля возвращаемых данных были переименованы. Список изменений по ссылке.

Как использовать API
Примеры использования различных методов
Примеры возвращаемых данных
Каталог авто (премиум подписка)
Калькулятор растаможки
Список последних изменений (changelog)

Любой запрос должен иметь:

HTTP заголовок Accept: application/json
HTTP заголовок X-Api-Key: API_KEY

Ответ от сервера:

HTTP заголовок X-RateLimit-Remaining указывает количество оставшихся запросов на текущий месяц для вашего ключа.

Приводим примеры использования различных методов API.

Curl / терминал: (рекомендуем jq)

curl -H 'Accept: application/json' -H 'X-Api-Key: $API_KEY' 'https://baza-gai.com.ua/nomer/KA0007XB'

JS:

let url = "https://baza-gai.com.ua/nomer/KA0007XB";
let key = "$API_KEY";
let request = fetch(url, {headers: {"Accept": "application/json", "X-Api-Key": key}}).then(r => r.json());
let data = await request;
// или
// let data; request.then(d => data = d);

Ruby: (модуль HTTParty)

require "httparty"
key = "$API_KEY"
url = "https://baza-gai.com.ua/nomer/KA0007XB"
data = HTTParty.get(url, {headers: {"Accept" => "application/json", "X-Api-Key" => key}})

Python: (модуль requests)

import requests
key = "$API_KEY"
url = "https://baza-gai.com.ua/nomer/KA0007XB"
r = requests.get(url, headers={"Accept": "application/json", "X-Api-Key": key})
data = r.json()

Node.js: (модуль got)

let got = require("got");
let key = "$API_KEY";
let url = "https://baza-gai.com.ua/nomer/KA0007XB";
let data = await got(url, {headers: {"Accept": "application/json", "X-Api-Key": key}}).json();

PHP:

$opts = [
  "http" => [
    "method" => "GET",
    "header" => "Accept: application/json\r\n"."X-Api-Key: $API_KEY\r\n"
  ]
];
$context = stream_context_create($opts);
$data = json_decode(file_get_contents("https://baza-gai.com.ua/nomer/KA0007XB", false, $context));

Примеры возвращаемых данных

`/nomer/:digits`

Позволяет получить данные об одном номере.

curl -H 'Accept: application/json' -H 'X-Api-Key: $API_KEY' 'https://baza-gai.com.ua/nomer/KA0007XB'

{
  "digits": "KA0007XB",
  "vin": "WBA7########57838", // VIN-код сейчас доступен только для регистраций c 2021 года
  "region": {
    "name": "г. Киев",
    "name_ua": "м. Київ",
    "slug": "kyiv",
    "old_code": "AA",
    "new_code": "KA"
  },
  "vendor": "BMW",
  "model": "M760LI",
  "model_year": 2021,
  "photo_url": "https://baza-gai.com.ua/catalog-images/bmw/7er/VI (G11-G12) Рестайлинг/image.jpg",
  "is_stolen": false,
  "stolen_details": null, // пример данных об украденном авто приведен дальше в документации
  "operations": [
    {
      "is_last": true,
      "catalog_model_title": "LS", // при подписке от 10 тыс. запросов
      "catalog_model_slug": "ls", // при подписке от 10 тыс. запросов
      "body": { // при подписке от 10 тыс. запросов
        "id": 4,
        "ua": "СЕДАН",
        "ru": "Седан"
      },
      "purpose": { // при подписке от 10 тыс. запросов
          "id": 1,
          "ua": "ЗАГАЛЬНИЙ",
          "ru": "Общий"
      },
      "registered_at": "03.04.2021",
      "model_year": 2021,
      "vendor": "BMW",
      "vendor_slug": "bmw",
      "model": "M760LI",
      "operation": {
        "ru": "Первичная регистрация нового ТС, автосалон, ввезено из-за границы",
        "ua": "Первинна реєстрація нового тз придбаного в торгівельній організації, який ввезено з-за кордону"
      },
      "department": "ТСЦ 8047",
      "color": {
        "slug": "gray",
        "ru": "Серый",
        "ua": "Сірий"
      },
      "is_registered_to_company": false,
      "address": "м.Київ, Деснянський",
      "koatuu": 8036400000,
      "displacement": 6592,
      "kind": {
        "id": 1,
        "ru": "Легковой",
        "ua": "Легковий",
        "slug": "car"
      },
      "operation_group": {
        "id": 1,
        "ru": "Первичная регистрация",
        "ua": "Первинна реєстрація"
      }
    },
    ...
  ],
  "comments": [
    {
      "id": 1,
      "name": "Василий",
      "text": "Спасибо, что помогли прикурить авто!",
      "created_at": "2022-11-19T18:49:30.392+02:00",
      "updated_at": "2022-11-19T18:49:30.392+02:00"
    },
    ...
  ]
}

`/vin/:vin`

Позволяет получить данные об авто и его регистрациях по VIN коду.

VIN коды сейчас доступны толко для авто зарегистрированных с 2021 года.

curl -H 'Accept: application/json' -H 'X-Api-Key: $API_KEY' 'https://baza-gai.com.ua/vin/WBA7########57838'

{
  "digits": "KA0007XB",
  "vin": "WBA7########57838", // VIN-код сейчас доступен только для регистраций c 2021 года
  "region": {
    "name": "г. Киев",
    "name_ua": "м. Київ",
    "slug": "kyiv",
    "old_code": "AA",
    "new_code": "KA"
  },
  "vendor": "BMW",
  "model": "M760LI",
  "model_year": 2021,
  "photo_url": "https://baza-gai.com.ua/catalog-images/bmw/7er/VI (G11-G12) Рестайлинг/image.jpg",
  "is_stolen": false,
  "stolen_details": null, // пример данных об украденном авто приведен дальше в документации
  "operations": [
    {
      "digits": "KA0007XB",
      "is_last": true,
      "catalog_model_title": "7 серия", // при подписке от 10 тыс. запросов
      "catalog_model_slug": "7er", // при подписке от 10 тыс. запросов
      "body": { // при подписке от 10 тыс. запросов
        "id": 4,
        "ua": "СЕДАН",
        "ru": "Седан"
      },
      "purpose": { // при подписке от 10 тыс. запросов
          "id": 1,
          "ua": "ЗАГАЛЬНИЙ",
          "ru": "Общий"
      },
      "registered_at": "03.04.2021",
      "model_year": 2021,
      "vendor": "BMW",
      "vendor_slug": "bmw",
      "model": "M760LI",
      "operation": {
        "ru": "Первичная регистрация нового ТС, автосалон, ввезено из-за границы",
        "ua": "Первинна реєстрація нового тз придбаного в торгівельній організації, який ввезено з-за кордону"
      },
      "department": "ТСЦ 8047",
      "color": {
        "slug": "gray",
        "ru": "Серый",
        "ua": "Сірий"
      },
      "is_registered_to_company": false,
      "address": "м.Київ, Деснянський",
      "koatuu": 8036400000,
      "displacement": 6592,
      "kind": {
        "id": 1,
        "ru": "Легковой",
        "ua": "Легковий",
        "slug": "car"
      },
      "operation_group": {
        "id": 1,
        "ru": "Первичная регистрация",
        "ua": "Первинна реєстрація"
      }
    },
    ...
  ]
}

Пример возращаеммых данных об украденном авто в поле stolen_details при запросе информации о номере или VIN коде.

{
   // информация о номере или VIN коде, как на примере выше
  ...
  "stolen_details": [
    {
      "theft_at": "15.01.2022",
      "vendor_title": "MERCEDES-BENZ - ATEGO 1828",
      "color": {
        "id": 6,
        "title": {
          "ru": "Бежевый",
          "ua": "БЕЖЕВИЙ"
        },
        "slug": "beige"
      },
      "raw_color": "БЕЖЕВИЙ",
      "car_type": "Вантажний автотранспорт",
      "chassis_number": "WDB9########52904",
      "body_number": "WDB9########51947",
      "department_title": "ГОЛОВНЕ УПРАВЛІННЯ НАЦІОНАЛЬНОЇ ПОЛІЦІЇ В РІВНЕНСЬКІЙ ОБЛАСТІ"
    }
    ...
  ],
  ...
}

`/nomer/:region`

Выдает информацию о регионе и коды региона.

:region - код региона. Например KA или BI.

curl -H 'Accept: application/json' -H 'X-Api-Key: $API_KEY' 'https://baza-gai.com.ua/nomer/KA'

{
    "name": {
        "ru": "г. Киев",
        "ua": "м. Київ"
    },
    "slug": "kyiv",
    "codes": [
        "AA",
        "KA",
        "TT",
        "TA"
    ]
}

`/nomer/:digits_first_part`

:digits_first_part - первая половина номера. Например KA11 или BI22.

Информация о регионе, коды региона
Комбинации номеров начинающиеся на указанную первую половину номера

curl -H 'Accept: application/json' -H 'X-Api-Key: $API_KEY' 'https://baza-gai.com.ua/nomer/KA11'

{
    "region": {
      "name": {
        "ru": "г. Киев",
        "ua": "м. Київ"
      },
      "slug": "kyiv",
      "codes": [
        "AA",
        "KA",
        "TT",
        "TA"
      ]
    },
    "plates": [
      "KA1100xx",
      "KA1101xx",
      "KA1102xx",
      ...
    ]
}

`/nomer/:digits_most_part`

:digits_most_part - часть номера. Например KA1111 или BI2222.

Информация о регионе, коды региона
Занятые комбинации
Свободные комбинации
Регистрации для указанной части номера

Параметры:

page

Номер страницы, например, /nomer/:digits_most_part?page=2. По умолчанию возвращается первая страница.

curl -H 'Accept: application/json' -H 'X-Api-Key: $API_KEY' 'https://baza-gai.com.ua/nomer/KA1111'

{
  "region": {
    "name": {
      "ru": "г. Киев",
      "ua": "м. Київ"
    },
    "slug": "kyiv",
    "codes": [
      "AA",
      "KA",
      "TT",
      "TA"
    ]
  },
  "endings_taken": [
    "AA",
    "AB",
    ...
  ],
  "endings_available": [
    "ET",
    "EX",
    ...
  ],
  "all_items_count": 159,
  "pages_count": 8,
  "current_page": 1,
  "plates": [
    {
      "digits": "KA1111MO",
      "registered_at": "31.07.2021",
      "model_year": 2021,
      "notes": "Серый, Дизель, 2.0L",
      "operation": {
        "group": "Первичная регистрация",
        "code": 105,
        "title_ru": "Первичная регистрация нового ТС, автосалон, ввезено из-за границы",
        "title_uk": "ПЕРВИННА РЕЄСТРАЦІЯ НОВОГО ТЗ ПРИДБАНОГО В ТОРГІВЕЛЬНІЙ ОРГАНІЗАЦІЇ, ЯКИЙ ВВЕЗЕНО З-ЗА КОРДОНУ"
      },
      "department": {
        "title": "ТСЦ 8043",
        "address": "04073, Київ, пр-т Степана Бандери, 26 В, ТЦ \"Метро\"\nреєстрація транспортного засобу,\nобмін (видача міжнародного) посвідчення водія\nоформлення довідок про несудимість"
      }
    },
    ...
  ]
}

`/make`

Выдает список всех производителей авто, как-то: BMW, Mercedes-Benz, и другие.

curl -H 'Accept: application/json' -H 'X-Api-Key: $API_KEY' 'https://baza-gai.com.ua/make'

[
  {
    "id": 1,
    "title": "BMW",
    "slug": "bmw"
  },
  {
    "id": 2,
    "title": "Mercedes-Benz",
    "slug": "mercedes-benz"
  },
  ...
]

`/make/:vendor`

Выдает данные об одном конкретном автопроизводителе.

curl -H 'Accept: application/json' -H 'X-Api-Key: $API_KEY' 'https://baza-gai.com.ua/make/lamborghini'

{
  "id": 649,
  "title": "Lamborghini",
  "slug": "lamborghini",
  "first_registration_count": 32,
  "all_registration_count": 129,
  "first_registration_count_by_years": {
    "2021": 10,
    "2020": 8,
    "2019": 7,
    "2018": 2,
    "2017": 0,
    "2016": 2
  },
  "catalog_models": [
    {
      "slug": "aventador",
      "title": "Aventador",
      "plate_count": 8,
      "first_registration_count": 2,
      "years": "2011 – н.в.",
      "photo_url": "https://baza-gai.com.ua/catalog-images/lamborghini/aventador/model.jpg",
    },
    {
      "slug": "huracan",
      "title": "Huracán",
      "plate_count": 15,
      "first_registration_count": 8
      "years": "2014 – н.в.",
      "photo_url": "https://baza-gai.com.ua/catalog-images/lamborghini/huracan/model.jpg",
    },
    ...
  ],
  "other_models": {
    "Легковой": [
      {
        "kind_id": 1,
        "title": "",
        "slug": "",
        "plate_count": 1
      }
    ]
  }
}

`/make/:vendor/:model`

Выдает данные о конкретной модели авто определенного производителя.

curl -H 'Accept: application/json' -H 'X-Api-Key: $API_KEY' 'https://baza-gai.com.ua/make/lamborghini/huracan'

{
  "id": 35276,
  "title": "HURACAN",
  "slug": "huracan",
  "full_title": "Lamborghini HURACAN",
  "catalog_model": {
    "id": 379,
    "vendor_id": 649,
    "slug": "huracan",
    "title": "Huracán",
    "plate_count": 13,
    "years": "2014 – н.в.",
    "is_current": true,
    "description": "",
    "year_from": 2014,
    "year_to": null,
    "photo_url": "https://baza-gai.com.ua/catalog-images/lamborghini/huracan/model.jpg",
  },
}

`/popular`

Самые популярные новые автомобили в 2024 (top_new_cars)
Самые популярные марки в 2024 (top_new_vendors)
Самые популярные авто на вторичке (top_secondary_vendors)

curl -H 'Accept: application/json' -H 'X-Api-Key: $API_KEY' 'https://baza-gai.com.ua/popular'

{
  "top_new_cars": [
    {
      "vendor": {
        "id": 16,
        "title": "Renault",
        "slug": "renault"
      },
      "model": {
        "id": 1835,
        "title": "Megane",
        "slug": "megane",
        "first_registration_count": 15266
      },
    },
    ...
  ],
 "top_new_vendors": [
    {
      "id": 8,
      "vendor": "Volkswagen",
      "slug": "volkswagen",
      "first_registration_count": 48612
    },
    ...
  ],
  "top_secondary_vendors": [
    {
      "id": 9,
      "vendor": "ВАЗ",
      "slug": "vaz",
      "all_registration_count": 1365875
    },
    ...
  ]
}

/search

Расширенный поиск. Параметры поиска:
- vendor
  slug производителя. Например audi, bmw, mercedes-benz.
  Список производителей и их slug можно получить отправив запрос на путь /make.
- catalog_model
  slug модели из каталога. Например a4, m5, c-klasse.
  Список моделей из каталога и их slug можно получить отправив запрос на путь /make/:vendor.
- year_from
  Год выпуска автомобиля. Например 2015, 2020.
  Можно комбинировать с параметром year_to, что бы указать промежуток для годов выпуска авто.
- year_to
  Год окончания выпуска автомобиля. Например 2015, 2020.
  Можно комбинировать с параметром year_from, что бы указать промежуток для годов выпуска авто.
- region
  Регион регистрации авто. Например kyiv, poltava-oblast. Получить список регионов можно отправив запрос на /plate_fields.
- fuel
  Тип топлива. Например petrol, diesel. Получить список типов топлива можно отправив запрос на /plate_fields.
- volume_from
  Объем двигателя автомобиля в литрах. Для поиска регистраций с заданным объемом и выше. Например 2, 2.5.
  Можно кобинировать с параметром volume_to что бы указать диапазон объема двигателя в котором искать регистрации.
- volume_to
  Объем двигателя автомобиля в литрах. Для поиска регистраций с заданным объемом и ниже. Например 2, 2.5.
  Можно кобинировать с параметром volume_from что бы указать диапазон объема двигателя в котором искать регистрации.
- color
  Цвет автомобиля. Например white, black. Получить список цветов можно отправив запрос на /plate_fields.
- body
  Кузов автомобиля. Например sedan, hatchback. Получить список кузовов можно отправив запрос на /plate_fields.
- operation_group
  Регистрация: primary (первичная), secondary (вторичная), removal (снятие с учета), other (другое),
- registered_from
  Год регистрации автомобиля. Для поиска регистраций с определенного года. Например 2015, 2020.
  Можно кобинировать с параметром registered_to что бы указать промежуток для годов регистрации авто.
- registered_to
  Год регистрации автомобиля. Для поиска регистраций до определенного года. Например 2015, 2020.
  Можно кобинировать с параметром registered_from что бы указать промежуток для годов регистрации авто.
- koatuu
  Идентификатор КОАТУУ. Например 8038600000 для "М.КИЇВ СВЯТОШИНСЬКИЙ".
  Для поиска регистраций по Классификатору объектов административно-территориального устройства Украины.
- page
  
  Номер страницы. Например 2, 3. По умолчанию возвращается первая страница.
Ниже пример с использованием всех возможных параметров для расширенного поиска.
```
curl -H 'Accept: application/json' -H 'X-Api-Key: $API_KEY' 'https://baza-gai.com.ua/search?vendor=mercedes-benz&catalog_model=c-klasse&year_from=2015&year_to=2021&region=poltava-oblast&fuel=2&volume_from=2.0&volume_to=3.0&color=white&body=4&operation_group=1&registered_from=2018&registered_to=2021'
```
```
{
  "all_items_count": 2,
  "pages_count": 1,
  "current_page": 1,
  "plates": [
    {
      "digits": "BI5050EA",
      "registered_at": "29.05.2019",
      "model_year": 2015,
      "notes": "Белый, 2.0L",
      "operation": {
        "group": "Первичная регистрация",
        "code": 71,
        "title_ru": "Регистрация, ввезено из-за границы по удостоверению таможни",
        "title_uk": "РЕЄСТРАЦІЯ ТЗ ПРИВЕЗЕНОГО З-ЗА КОРДОНУ ПО ПОСВІДЧЕННЮ МИТНИЦІ"
      },
      "department": {
        "title": "ТСЦ 5341",
        "address": "38751, Полтавська область, Полтавський район, с. Розсошенці, вул. Кременчуцька, 2В"
      }
    },
    ...
  ]
}
```

`/plate_fields`

Данные для расширенного поиска по адресу /search:

Регионы
Цвета авто
Кузова авто
Типы топлива

curl -H 'Accept: application/json' -H 'X-Api-Key: $API_KEY' 'https://baza-gai.com.ua/plate_fields'

{
  "regions": [
    {
        "name": {
            "ru": "г. Киев",
            "ua": "м. Київ"
        },
        "slug": "kyiv",
        "codes": [
            "AA",
            "KA",
            "TT",
            "TA"
        ]
    },
    ...
  ],
  "colors": [
    {
      "id": 1,
      "title": {
          "ru": "Черный",
          "ua": "ЧОРНИЙ"
      },
      "slug": "black"
    },
    ...
  ],
  "bodies": [
    {
      "id": 93,
      "title": {
        "ru": "Кабриолет",
        "ua": "КАБРІОЛЕТ"
      },
      "slug": "convertible"
    },
    ...
  ],
   "fuels": [
    {
      "id": 1,
      "title": {
          "ru": "Дизель",
          "ua": "ДИЗЕЛЬНЕ ПАЛИВО"
      },
      "slug": "diesel"
    },
    ...
  ]
}

`/catalog/:vendor/:model`

Выдает данные о модели из каталога авто определенного производителя.

Количество первичных/вторичнах регистраций
Технические характеристики модели

Путь доступен только при подписке от 10000 запросов в месяц.

curl -H 'Accept: application/json' -H 'X-Api-Key: $API_KEY' 'https://baza-gai.com.ua/catalog/lamborghini/huracan'

{
  "id": 379,
  "title": "Huracán",
  "slug": "huracan",
  "full_title": "Lamborghini Huracán",
  "first_registration_count": 8,
  "all_registration_count": 21,
  "production": "2014 – н.в.",
  "photo_url": "https://baza-gai.com.ua/catalog-images/lamborghini/huracan/model.jpg",
  "specs": [
    {
      "id": 3410,
      "title": "Huracán Evo",
      "introduced": 2019,
      "engine_type": "Naturally aspirated V10",
      "displacement": "5.2 л (318 дюйм³ / 5204 см³)",
      "power": "640 л.с. (эффективная мощность 631 л.с. / 471 кВт)  @ 8000 об/мин",
      "torque": "600 Н·м (443 lb-ft)  @ 6500 об/мин",
      "curb_weight": "1422-1665 кг (3135-3671 фунт)",
      "transmission": "7-ступенчатая автоматическая с двойным сцеплением",
      "car_type": "Купе",
      "car_layout": "среднемоторная, полноприводная",
      "generation": null,
      "dimensions": "4.52 м (178 in) длина, 1.93 м (76 in) ширина, 1.17 м (46 in) высота",
      "wheelbase": null,
      "origin_country": "Италия",
      "years_built": null,
      "eur_price": "€214,003 - €283,120",
      "us_price": "$274,769 - $334,969",
      "power_5000": "14 л.c.",
      "performance": {
          "accel_0_100": 2.6,
          "accel_0_200": 8.9,
          "accel_0_250": 15.2,
          "accel_0_300": 27.1,
          "brake_100_0": 30,
          "brake_200_0": 122,
          "time_402m": 10.3,
          "speed_at_402m": null,
          "time_1000m": 19.1,
          "speed_at_1000m": 271.6,
          "top_speed": "328 км/ч (204 миль/ч)"
      }
    },
    ...
  ]
}

`/catalog/:vendor/:model/photos`

Выдает фото разных поколений и кузовов модели из каталога авто.

Путь доступен только при подписке от 10000 запросов в месяц.

curl -H 'Accept: application/json' -H 'X-Api-Key: $API_KEY' 'https://baza-gai.com.ua/catalog/lamborghini/aventador/photos'

{
  "title": "Lamborghini Aventador",
  "vendor_slug": "lamborghini",
  "catalog_model_slug": "aventador",
  "generations": [
    {
      "id": 840,
      "name": "I Рестайлинг",
      "years": "2016 – н.в.",
      "bodies": [
        {
          "id": 1236,
          "name": "Купе",
          "photos": [
            {
              "img_path": "https://baza-gai.com.ua/catalog-images/lamborghini/aventador/I Рестайлинг/Купе/images/0.jpg",
              "thumb_path": "https://baza-gai.com.ua/catalog-images/lamborghini/aventador/I Рестайлинг/Купе/thumbs/0.jpg"
            },
            {
              "img_path": "https://baza-gai.com.ua/catalog-images/lamborghini/aventador/I Рестайлинг/Купе/images/1.jpg",
              "thumb_path": "https://baza-gai.com.ua/catalog-images/lamborghini/aventador/I Рестайлинг/Купе/thumbs/1.jpg"
            },
            ...
          ]
        },
        ...
      ]
    },
  ...
}

`/catalog/:vendor/:model/plates`

Выдает информацию о регистрациях для модели из каталога.

Параметры:

page

Номер страницы, например, /catalog/:vendor/:model/plates?page=2.

По умолчанию возвращается первая страница.
order

Сортировка по заданному значению. Доступна сортировка по году модели (model_year) и по году регистрации (registered_at). Например order=model_year или order=registered_at.

По умолчанию используется сортировка по году регистрации (registered_at) в порядке убывания (DESC).
order_type

Порядок сортировки. По возрастанию (ASC) или по убыванию (DESC). Например order_type=ASC или order_type=DESC

По умолчанию сортировка в порядке убывания (DESC).

Путь доступен только при подписке от 10000 запросов в месяц.

curl -H 'Accept: application/json' -H 'X-Api-Key: $API_KEY' 'https://baza-gai.com.ua/catalog/bmw/3er/plates?order=registered_at&order_type=desc&page=1'

{
  "id": 240,
  "title": "3 серия",
  "slug": "3er",
  "full_title": "BMW 3 серия",
  "production": "1975 – н.в.",
  "photo_url": "https://baza-gai.com.ua/catalog-images/bmw/3er/model.jpg",
  "first_registration_count": 17760,
  "all_registration_count": 66459,
  "first_registration_count_by_years": {
    "2021": 2701,
    "2020": 3482,
    "2019": 8021,
    "2018": 1693,
    "2017": 749,
    "2016": 337
  },
  "all_items_count": 66459,
  "pages_count": 3323,
  "current_page": 3,
  "plates": [
    {
        "digits": "BH9787OO",
        "registered_at": "31.07.2021",
        "model_year": 2017,
        "notes": "Черный, Дизель, 2.0L",
        "operation": {
            "group": "Вторичная регистрация",
            "code": 315,
            "title_ru": "Перерегистрация, новый собственник (договор в ТСЦ)",
            "title_uk": "ПЕРЕРЕЄСТРАЦІЯ ТЗ НА НОВ. ВЛАСН. ПО ДОГОВОРУ УКЛАДЕНОМУ В ТСЦ"
        },
        "department": {
            "title": "ТСЦ 5141",
            "address": "65114, м. Одеса, вул. Ак. Корольова, 5"
        }
    },
    ...
  ]
}

Калькулятор растаможки

Для рассчета стоимости растоможки авто нужно отправить GET запрос с набором параметров (тип авто, объем двигателя, год выпуска и т.д.). На странице калькулятора растаможки можно наглядно ознакомиться с необходимыми параметрами для разных типов авто.

Обязательные параметры для всех типов авто:

car_type

Тип авто: car, electric, hybrid, motorcycle, truck
price

Стоимость авто. Например 10000
currency

Валюта: USD, EUR, UAH

Легковые авто (тип авто `car`):

volume

Объем двигателя в литрах (дм³). Например 2.5 или 1.6
motor

Тип топлива (бензин или дизель): petrol, diesel
year

Год выпуска автомобиля. Например 2021

Электромобили (тип авто `electric`):

power

Мощность, кВт⋅ч: Например 150

Гибридные (тип авто `hybrid`):

Только обязательные параметры (car_type, price, currency)

Мото (тип авто `motorcycle`):

volume

Объем двигателя в см³. Например 150

Грузовые (тип авто `truck`):

vehicle_type

Тип кузова (грузовик или тягач/фура): lorry, truck.
Если тип кузова truck то все нижеперечисленные параметры (volume, weight, year, motor) можно не указывать.
volume

Объем двигателя в литрах (дм³). Например 2.5 или 1.6
weight

Полная масса, кг. Например 5000
year

Год выпуска автомобиля. Например 2021
motor

Тип топлива (бензин или дизель): petrol, diesel

Пример запроса и возвращаемых данных

curl -H 'Accept: application/json' -H 'X-Api-Key: $API_KEY' 'https://baza-gai.com.ua/taxes?currency=EUR&car_type=car&price=10000&volume=2.0&motor=diesel&year=2018'

{
  "origin_price": 10000, // цена в запросе
  "nds": 2260, // налог на добавленную стоимость (пдв)
  "duty": 1000, // пошлина
  "excise": 300, // акциз
  "pension_fund": 339, // пенсионный фонд
  "all_fees": 3560, // все сборы
  "all_fees_with_pension_fund": 3899, // все сборы + пенсионный фонд
  "result_price": 13899.0, // цена с растаможкой
  "currency": "EUR", // валюта
  "result_price_usd": 16540, // цена с расстаможкой USD
  "result_price_eur": 13899, // цена с расстаможкой EUR
  "result_price_uah": 464922, // цена с расстаможкой UAH

  // все поля ниже будут скоро удалены, выше указаны соответствующие актуальные поля
  "originPrice": 10000,
  "pensionFund": 339,
  "allFees": 3560,
  "allFeesWithPensionFund": 3899,
  "resultPrice": 13899.0,
  "resultPriceUsd": 16540,
  "resultPriceEur": 13899,
  "resultPriceUah": 464922
}

Проверка авто по номеру и VIN

Форма для получения API ключа

API

Приводим примеры использования различных методов API.

Примеры возвращаемых данных

/nomer/:digits

/vin/:vin

/nomer/:region

/nomer/:digits_first_part

/nomer/:digits_most_part

Параметры:

page

/make

/make/:vendor

/make/:vendor/:model

/popular

/search

page

/plate_fields

/catalog/:vendor/:model

/catalog/:vendor/:model/photos

/catalog/:vendor/:model/plates

Параметры:

page

order

order_type

Калькулятор растаможки

Обязательные параметры для всех типов авто:

car_type

price

currency

Легковые авто (тип авто car):

volume

motor

year

Электромобили (тип авто electric):

power

Гибридные (тип авто hybrid):

Мото (тип авто motorcycle):

volume

Грузовые (тип авто truck):

vehicle_type

volume

weight

year

motor

Пример запроса и возвращаемых данных

`/nomer/:digits`

`/vin/:vin`

`/nomer/:region`

`/nomer/:digits_first_part`

`/nomer/:digits_most_part`

`page`

`/make`

`/make/:vendor`

`/make/:vendor/:model`

`/popular`

`/search`

`page`

`/plate_fields`

`/catalog/:vendor/:model`

`/catalog/:vendor/:model/photos`

`/catalog/:vendor/:model/plates`

`page`

`order`

`order_type`

`car_type`

`price`

`currency`

Легковые авто (тип авто `car`):

`volume`

`motor`

`year`

Электромобили (тип авто `electric`):

`power`

Гибридные (тип авто `hybrid`):

Мото (тип авто `motorcycle`):

`volume`

Грузовые (тип авто `truck`):

`vehicle_type`

`volume`

`weight`

`year`

`motor`