Базова адреса: https://api.uacars.qper.cloud/v1 · Формат: JSON (UTF-8) · Ключ доступу: не потрібен.

1. Загальний принцип

Пошук інформації про транспортний засіб за одним із трьох ідентифікаторів: державний номерний знак (AA1234BB), VIN-код (17 символів) або номер агрегата (кузова/шасі/двигуна). Значення передається в параметрі q, тип визначається автоматично — або вказується явно параметром type.

2. GET /v1/search

Параметр	Обов'язковий	Значення
q	так	Номерний знак, VIN або номер агрегата
type	ні	plate, vin, aggregate або auto (за замовчуванням)

curl "https://api.uacars.qper.cloud/v1/search?q=AA1234BB"
curl "https://api.uacars.qper.cloud/v1/search?q=WVWZZZ1KZAW123456&type=vin"

Відповідь — інформацію знайдено:

{
  "success": true,
  "query": { "value": "AA1234BB", "type": "plate" },
  "found": true,
  "vehicle": {
    "plate_number": "AA1234BB",
    "vin": "WVWZZZ1KZAW123456",
    "brand": "TOYOTA",
    "model": "CAMRY",
    "manufacture_year": 2019,
    "color": "чорний",
    "vehicle_type": "легковий",
    "fuel_type": "бензин",
    "engine_capacity_cm3": 2494,
    "total_weight_kg": 1850,
    "own_weight_kg": 1420,
    "last_operation_date": "2023-02-01",
    "last_operation_type": "перереєстрація",
    "region": "м. Київ",
    "owner_type": "фізична особа"
  },
  "wanted": { "is_wanted": false },
  "meta": {
    "dataset_source": "data.gov.ua",
    "dataset_updated_at": "2026-08-06",
    "disclaimer": "Дані надаються довідково і не є офіційним джерелом для юридично значущих цілей."
  }
}

Поле	Опис
found	true, якщо запис знайдено в реєстрі або в базі розшуку
vehicle.vehicle_type	Тип ТЗ одним полем (окремих категорії/типу кузова реєстр не веде)
vehicle.last_operation_date/_type	Дата й тип ОСТАННЬОЇ операції в реєстрі (реєстр — журнал операцій, дати першої реєстрації в ньому немає)
wanted.is_wanted	true, якщо ТЗ перебуває в розшуку у зв'язку з незаконним заволодінням
meta.dataset_updated_at	Дата останнього оновлення даних реєстру

Персональні дані власника (ПІБ, адреса) API не надає — лише категорія власності (owner_type).

Відповідь — нічого не знайдено:

{
  "success": true,
  "query": { "value": "AA9999ZZ", "type": "plate" },
  "found": false,
  "vehicle": null,
  "message": "За вказаним запитом інформацію не знайдено."
}

3. GET /v1/health

Перевірка доступності сервісу та дати останнього оновлення датасетів.

curl "https://api.uacars.qper.cloud/v1/health"

{
  "status": "ok",
  "api_version": "1.0.0",
  "dataset": {
    "registry_updated_at": "2026-08-06",
    "wanted_list_updated_at": "2026-09-13"
  }
}

Якщо дані реєстру тимчасово недоступні: 503 і {"status":"unavailable"}.

4. Формати вхідних значень

Тип	Приклад	Правила
Номерний знак	AA1234BB	2 літери + 4 цифри + 2 літери; кирилицею або латиницею; пробіли/дефіси не обов'язкові
VIN-код	WVWZZZ1KZAW123456	Рівно 17 символів; без літер I, O, Q
Номер агрегата	довільний	Буквено-цифровий номер кузова, шасі або двигуна

5. Коди помилок

HTTP	error.code	Значення
400	MISSING_QUERY	Не передано параметр q
400	INVALID_QUERY_FORMAT	Значення не відповідає жодному з форматів
404	NOT_FOUND	Такого маршруту API не існує
429	RATE_LIMIT_EXCEEDED	Перевищено ліміт запитів
500	INTERNAL_ERROR	Внутрішня помилка сервера — спробуйте пізніше

{
  "success": false,
  "error": {
    "code": "INVALID_QUERY_FORMAT",
    "message": "Невірний формат державного номера, VIN-коду або номера агрегата."
  }
}

6. Обмеження на кількість запитів

1 запит на хвилину з однієї IP-адреси на весь /v1/*. Поточний ліміт і залишок повертаються в заголовках відповіді:

X-RateLimit-Limit: 1
X-RateLimit-Remaining: 0
Retry-After: 42

7. Конфіденційність запитів

Сервіс не зберігає та не передає третім особам значення пошукових запитів (номер, VIN, номер агрегата) у відкритому вигляді. Відповіді API не містять ПІБ або адреси власника ТЗ.

8. Джерело даних і застереження

Дані — на основі відкритих наборів даних data.gov.ua: «Відомості про транспортні засоби та їх власників» і «Транспортні засоби, що перебувають у розшуку». Сервіс не є офіційним джерелом для юридично значущих цілей (суд, нотаріус, органи влади) — для таких випадків звертайтеся за офіційним витягом через сервіс «Дія» або МВС України.

9. Підтримка

Веб-інтерфейс: uacars.qper.cloud · Telegram-бот: @qpercars_bot · Питання щодо API — через контактну форму на сайті.