Skip to content

opencars/docs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OpenCars API

API для публічної інформації про транспортні засоби України

Table of Contents

## Servers
URL Description
https://api.opencars.app/api/v1/

Security

Type In Name Scheme Format Description
apiKey header Api-Key

Paths

GET /operations

Інформація про операції за реєстраційним номером

▷ number

Реєстраційний номер

Name Type In Description Accepted values
number (required) string query Реєстраційний номер Any
▷ limit

Кількість записів

Name Type In Description Accepted values
limit integer query Кількість записів Any
▷ order

Порядок сортування

Name Type In Description Accepted values
order string query Порядок сортування asc, desc

Responses

▶ 200 - OK
Headers

No headers specified

application/json
Name Type Description Accepted values
Response array(object) Any
Response.number string Реєстраційний номер Any
Response.brand string Марка Any
Response.model string Модель Any
Response.year integer Рік випуску Any
Response.date string Дата проведення операції Any
Response.registration string Вид реєстрації Any
Response.registration_code integer Код виду реєстрації Any
Response.fuel string Тип пального Any
Response.capacity number Об'єм двигуна Any
Response.color string Колір транспортного засобу Any
Response.kind string Тип транспортного засобу Any
Response.body string Тип кузову Any
Response.purpose string Призначення Any
Response.own_weight integer Маса без навантаження Any
Response.total_weight integer Повна маса Any
Response.reg_addr_koatuu string Адреса реєстрацiї у форматі КОАТУУ Any
Response.dep_code integer Код департаменту Any
Response.dep string Назва департаменту Any
Response.person string Назва департаменту Any
Example (generated)
[
  {
    "number": "АА9359РС",
    "brand": "TESLA",
    "model": "MODEL X",
    "year": 2016,
    "date": "2016-10-13",
    "registration": "РЕЄСТРАЦIЯ ТЗ ПРИВЕЗЕНОГО З-ЗА КОРДОНУ ПО ВМД",
    "registration_code": 70,
    "fuel": "ЕЛЕКТРО",
    "capacity": null,
    "color": "ЧОРНИЙ",
    "kind": "ЛЕГКОВИЙ",
    "body": "УНІВЕРСАЛ-B",
    "purpose": "ЗАГАЛЬНИЙ",
    "own_weight": 2485,
    "total_weight": 3021,
    "reg_addr_koatuu": "8036600000",
    "dep_code": 8044,
    "dep": "Центр 8044",
    "person": "Юридична особа"
  }
]
▶ 400 - Помилковий запит
Headers

No headers specified

application/json
Name Type Description Accepted values
error string Опис помилки Any
Example (generated)
{
  "error": "string"
}
▶ 401 - Потрібна Авторизація
Headers

No headers specified

▶ 405 - Помилковий метод
Headers

No headers specified

application/json
Name Type Description Accepted values
error string Опис помилки Any
Example (generated)
{
  "error": "string"
}
▶ 500 - Помилка
Headers

No headers specified

application/json
Name Type Description Accepted values
error string Опис помилки Any
Example (generated)
{
  "error": "string"
}

Tags

GET /registrations

Інформація про реєстрації транспортного засобу

▷ number

Реєстраційний номер

Name Type In Description Accepted values
number string query Реєстраційний номер Any
▷ vin

VIN

Name Type In Description Accepted values
vin string query VIN Any
▷ code

Номер свідотства про реєстрацію

Name Type In Description Accepted values
code string query Номер свідотства про реєстрацію Any

Responses

▶ 200 - OK
Headers

No headers specified

application/json
Name Type Description Accepted values
Response array(object) Any
Response.number string Реєстраційний номер Any
Response.code string Номер свідоцтва про реєстрацію транспортного засобу Any
Response.vin string VIN-код Any
Response.brand string Марка Any
Response.model string Модель Any
Response.capacity number Об'єм двигуна Any
Response.rank_category string Категорія транспортного засобу Any
Response.num_seating integer Кількість стоячих місць Any
Response.num_standing integer Кількість сидячих місць Any
Response.color string Колір Any
Response.date string Дата реєстрації Any
Response.first_reg_date string Дата першої реєстрації Any
Response.fuel string Тип пального Any
Response.kind string Тип Any
Response.own_weight number Маса без навантаження Any
Response.total_weight number Повна маса Any
Response.year integer Рік випуску Any
Example (generated)
[
  {
    "number": "АА9359РС",
    "code": "СХН484154",
    "vin": "5YJXCCE40GF010543",
    "brand": "TESLA",
    "model": "MODEL X",
    "capacity": null,
    "rank_category": "B",
    "num_seating": null,
    "num_standing": 7,
    "color": "ЧОРНИЙ",
    "date": "2019-06-05",
    "first_reg_date": "2016-10-13",
    "fuel": "ЕЛЕКТРО",
    "kind": "ЛЕГКОВИЙ УНІВЕРСАЛ-B",
    "own_weight": 2485,
    "total_weight": 3021,
    "year": 2016
  }
]
▶ 400 - Помилковий запит
Headers

No headers specified

application/json
Name Type Description Accepted values
error string Опис помилки Any
Example (generated)
{
  "error": "string"
}
▶ 401 - Потрібна Авторизація
Headers

No headers specified

▶ 405 - Помилковий метод
Headers

No headers specified

application/json
Name Type Description Accepted values
error string Опис помилки Any
Example (generated)
{
  "error": "string"
}
▶ 500 - Помилка
Headers

No headers specified

application/json
Name Type Description Accepted values
error string Опис помилки Any
Example (generated)
{
  "error": "string"
}

Tags

GET /registrations/{code}

Реєстрація транспортного засобу за номером свідотства

▷ code

Номер свідотства про реєстрацію

Name Type In Description Accepted values
code (required) string path Номер свідотства про реєстрацію Any

Responses

▶ 200 - OK
Headers

No headers specified

application/json
Name Type Description Accepted values
number string Реєстраційний номер Any
code string Номер свідоцтва про реєстрацію транспортного засобу Any
vin string VIN-код Any
brand string Марка Any
model string Модель Any
capacity number Об'єм двигуна Any
rank_category string Категорія транспортного засобу Any
num_seating integer Кількість стоячих місць Any
num_standing integer Кількість сидячих місць Any
color string Колір Any
date string Дата реєстрації Any
first_reg_date string Дата першої реєстрації Any
fuel string Тип пального Any
kind string Тип Any
own_weight number Маса без навантаження Any
total_weight number Повна маса Any
year integer Рік випуску Any
Example (generated)
{
  "number": "АА9359РС",
  "code": "СХН484154",
  "vin": "5YJXCCE40GF010543",
  "brand": "TESLA",
  "model": "MODEL X",
  "capacity": null,
  "rank_category": "B",
  "num_seating": null,
  "num_standing": 7,
  "color": "ЧОРНИЙ",
  "date": "2019-06-05",
  "first_reg_date": "2016-10-13",
  "fuel": "ЕЛЕКТРО",
  "kind": "ЛЕГКОВИЙ УНІВЕРСАЛ-B",
  "own_weight": 2485,
  "total_weight": 3021,
  "year": 2016
}
▶ 400 - Помилковий запит
Headers

No headers specified

application/json
Name Type Description Accepted values
error string Опис помилки Any
Example (generated)
{
  "error": "string"
}
▶ 401 - Потрібна Авторизація
Headers

No headers specified

▶ 405 - Помилковий метод
Headers

No headers specified

application/json
Name Type Description Accepted values
error string Опис помилки Any
Example (generated)
{
  "error": "string"
}
▶ 500 - Помилка
Headers

No headers specified

application/json
Name Type Description Accepted values
error string Опис помилки Any
Example (generated)
{
  "error": "string"
}

Tags

GET /wanted/vehicles

Інформація про викрадені транспортні засоби

▷ number

Реєстраційний номер

Name Type In Description Accepted values
number string query Реєстраційний номер Any
▷ vin

VIN-код

Name Type In Description Accepted values
vin string query VIN-код Any
▷ revision

Номер ревізії

Name Type In Description Accepted values
revision integer query Номер ревізії Any

Responses

▶ 200 - OK
Headers

No headers specified

application/json
Name Type Description Accepted values
Response array(object) Any
Response.id string Унікальний номер викраденого транспортного засобу Any
Response.brand string Інформація про транспортний засіб Any
Response.color string Колір транспортного засобу Any
Response.number string Реєстраційний номер Any
Response.body_number string Номер кузова Any
Response.chassis_number string Номер шасі Any
Response.engine_number string Номeр двигуна Any
Response.ovd string Орган, що вніс дані у реєстр Any
Response.kind string Тип транспортного засобу Any
Response.status string Статус розшуку транспортного засобу Any
Response.theft_date string Час викрадення транспортного засобу у форматі ISO 8601 Any
Response.insert_date string Час внесення інформації у рееєстр у форматі ISO 8601 Any
Example (generated)
[
  {
    "id": "00163195157556102859",
    "brand": "CHEVROLET - EXPRESS",
    "color": "ЗЕЛЕНИЙ",
    "number": "AA4686EH",
    "body_number": "1GBSHDC44D1126468",
    "chassis_number": "Ідентифікаційний номер транспортного засобу",
    "engine_number": null,
    "ovd": "ГЕНЕРАЛЬНА ПРОКУРАТУРА УКРАЇНИ",
    "kind": "ЛЕГКОВИЙ",
    "status": "stolen",
    "theft_date": "2016-11-14T00:00:00Z",
    "insert_date": "2016-11-14T14:19:35Z"
  }
]
▶ 400 - Помилковий запит
Headers

No headers specified

application/json
Name Type Description Accepted values
error string Опис помилки Any
Example (generated)
{
  "error": "string"
}
▶ 401 - Потрібна Авторизація
Headers

No headers specified

▶ 405 - Помилковий метод
Headers

No headers specified

application/json
Name Type Description Accepted values
error string Опис помилки Any
Example (generated)
{
  "error": "string"
}
▶ 500 - Помилка
Headers

No headers specified

application/json
Name Type Description Accepted values
error string Опис помилки Any
Example (generated)
{
  "error": "string"
}

Tags

GET /wanted/revisions

Інформація про оновлення реєстру викрадених транспортних засобів

▷ limit

Кількість елементів у відповіді

Name Type In Description Accepted values
limit integer query Кількість елементів у відповіді Any

Responses

▶ 200 - OK
Headers

No headers specified

application/json
Name Type Description Accepted values
Response array(object) Any
Response.id string Унікальний код оновлення реєстру Any
Response.name string Назва ресурсу Any
Response.url string Посилання на оновлений ресурс Any
Response.file_hash_sum string Хеш сума контенту файлу Any
Response.removed number Кількість видалених записів з реєстру Any
Response.added number Кількість доданих записів до реєстру Any
Response.created_at string Час оновлення даних у форматі ISO 8601 Any
Example (generated)
[
  {
    "id": "29092018_2",
    "name": "MVSWantedTransport_1.json",
    "url": "https://data.gov.ua/dataset/9b0e87e0-eaa3-4f14-9547-03d61b70abb6/resource/06e65b06-3120-4713-8003-7905a83f95f5/revision/29092018_2",
    "file_hash_sum": "f4ae97fb62c7c9b91d6b950c79deb716",
    "removed": 27019,
    "added": 43365,
    "created_at": "2018-09-29T22:33:33Z"
  }
]
▶ 400 - Помилковий запит
Headers

No headers specified

application/json
Name Type Description Accepted values
error string Опис помилки Any
Example (generated)
{
  "error": "string"
}
▶ 401 - Потрібна Авторизація
Headers

No headers specified

▶ 405 - Помилковий метод
Headers

No headers specified

application/json
Name Type Description Accepted values
error string Опис помилки Any
Example (generated)
{
  "error": "string"
}
▶ 500 - Помилка
Headers

No headers specified

application/json
Name Type Description Accepted values
error string Опис помилки Any
Example (generated)
{
  "error": "string"
}

Tags

GET /wanted/revisions/{id}

Відомості про оновлення реєстру за унікальним кодом

▷ id

Унікальний код оновлення реєстру

Name Type In Description Accepted values
id (required) string path Унікальний код оновлення реєстру Any

Responses

▶ 200 - OK
Headers

No headers specified

application/json
Name Type Description Accepted values
id string Унікальний код оновлення реєстру Any
name string Назва ресурсу Any
url string Посилання на оновлений ресурс Any
file_hash_sum string Хеш сума контенту файлу Any
removed number Кількість видалених записів з реєстру Any
added number Кількість доданих записів до реєстру Any
created_at string Час оновлення даних у форматі ISO 8601 Any
Example (generated)
{
  "id": "29092018_2",
  "name": "MVSWantedTransport_1.json",
  "url": "https://data.gov.ua/dataset/9b0e87e0-eaa3-4f14-9547-03d61b70abb6/resource/06e65b06-3120-4713-8003-7905a83f95f5/revision/29092018_2",
  "file_hash_sum": "f4ae97fb62c7c9b91d6b950c79deb716",
  "removed": 27019,
  "added": 43365,
  "created_at": "2018-09-29T22:33:33Z"
}
▶ 400 - Помилковий запит
Headers

No headers specified

application/json
Name Type Description Accepted values
error string Опис помилки Any
Example (generated)
{
  "error": "string"
}
▶ 401 - Потрібна Авторизація
Headers

No headers specified

▶ 405 - Помилковий метод
Headers

No headers specified

application/json
Name Type Description Accepted values
error string Опис помилки Any
Example (generated)
{
  "error": "string"
}
▶ 500 - Помилка
Headers

No headers specified

application/json
Name Type Description Accepted values
error string Опис помилки Any
Example (generated)
{
  "error": "string"
}

Tags

GET /wanted/revisions/stats

Статистика оновлення реєстру за останні 12 місяців

▶ 200 - OK
Headers

No headers specified

application/json
Name Type Description Accepted values
Response array(object) Any
Response.added integer Кількість доданих записів за місяць Any
Response.removed integer Кількість видалених записів за місяць Any
Response.month integer Місяць Any
Response.year integer Рік Any
Example (generated)
[
  {
    "added": 241,
    "removed": 195,
    "month": 2,
    "year": 2020
  }
]
▶ 400 - Помилковий запит
Headers

No headers specified

application/json
Name Type Description Accepted values
error string Опис помилки Any
Example (generated)
{
  "error": "string"
}
▶ 401 - Потрібна Авторизація
Headers

No headers specified

▶ 405 - Помилковий метод
Headers

No headers specified

application/json
Name Type Description Accepted values
error string Опис помилки Any
Example (generated)
{
  "error": "string"
}
▶ 500 - Помилка
Headers

No headers specified

application/json
Name Type Description Accepted values
error string Опис помилки Any
Example (generated)
{
  "error": "string"
}

Tags

Schemas

Name Type Description Accepted values
error string Опис помилки Any
Example (generated)
{
  "error": "string"
}
Name Type Description Accepted values
number string Реєстраційний номер Any
brand string Марка Any
model string Модель Any
year integer Рік випуску Any
date string Дата проведення операції Any
registration string Вид реєстрації Any
registration_code integer Код виду реєстрації Any
fuel string Тип пального Any
capacity number Об'єм двигуна Any
color string Колір транспортного засобу Any
kind string Тип транспортного засобу Any
body string Тип кузову Any
purpose string Призначення Any
own_weight integer Маса без навантаження Any
total_weight integer Повна маса Any
reg_addr_koatuu string Адреса реєстрацiї у форматі КОАТУУ Any
dep_code integer Код департаменту Any
dep string Назва департаменту Any
person string Назва департаменту Any
Example (generated)
{
  "number": "АА9359РС",
  "brand": "TESLA",
  "model": "MODEL X",
  "year": 2016,
  "date": "2016-10-13",
  "registration": "РЕЄСТРАЦIЯ ТЗ ПРИВЕЗЕНОГО З-ЗА КОРДОНУ ПО ВМД",
  "registration_code": 70,
  "fuel": "ЕЛЕКТРО",
  "capacity": null,
  "color": "ЧОРНИЙ",
  "kind": "ЛЕГКОВИЙ",
  "body": "УНІВЕРСАЛ-B",
  "purpose": "ЗАГАЛЬНИЙ",
  "own_weight": 2485,
  "total_weight": 3021,
  "reg_addr_koatuu": "8036600000",
  "dep_code": 8044,
  "dep": "Центр 8044",
  "person": "Юридична особа"
}
Name Type Description Accepted values
number string Реєстраційний номер Any
code string Номер свідоцтва про реєстрацію транспортного засобу Any
vin string VIN-код Any
brand string Марка Any
model string Модель Any
capacity number Об'єм двигуна Any
rank_category string Категорія транспортного засобу Any
num_seating integer Кількість стоячих місць Any
num_standing integer Кількість сидячих місць Any
color string Колір Any
date string Дата реєстрації Any
first_reg_date string Дата першої реєстрації Any
fuel string Тип пального Any
kind string Тип Any
own_weight number Маса без навантаження Any
total_weight number Повна маса Any
year integer Рік випуску Any
Example (generated)
{
  "number": "АА9359РС",
  "code": "СХН484154",
  "vin": "5YJXCCE40GF010543",
  "brand": "TESLA",
  "model": "MODEL X",
  "capacity": null,
  "rank_category": "B",
  "num_seating": null,
  "num_standing": 7,
  "color": "ЧОРНИЙ",
  "date": "2019-06-05",
  "first_reg_date": "2016-10-13",
  "fuel": "ЕЛЕКТРО",
  "kind": "ЛЕГКОВИЙ УНІВЕРСАЛ-B",
  "own_weight": 2485,
  "total_weight": 3021,
  "year": 2016
}
Name Type Description Accepted values
id string Унікальний номер викраденого транспортного засобу Any
brand string Інформація про транспортний засіб Any
color string Колір транспортного засобу Any
number string Реєстраційний номер Any
body_number string Номер кузова Any
chassis_number string Номер шасі Any
engine_number string Номeр двигуна Any
ovd string Орган, що вніс дані у реєстр Any
kind string Тип транспортного засобу Any
status string Статус розшуку транспортного засобу Any
theft_date string Час викрадення транспортного засобу у форматі ISO 8601 Any
insert_date string Час внесення інформації у рееєстр у форматі ISO 8601 Any
Example (generated)
{
  "id": "00163195157556102859",
  "brand": "CHEVROLET - EXPRESS",
  "color": "ЗЕЛЕНИЙ",
  "number": "AA4686EH",
  "body_number": "1GBSHDC44D1126468",
  "chassis_number": "Ідентифікаційний номер транспортного засобу",
  "engine_number": null,
  "ovd": "ГЕНЕРАЛЬНА ПРОКУРАТУРА УКРАЇНИ",
  "kind": "ЛЕГКОВИЙ",
  "status": "stolen",
  "theft_date": "2016-11-14T00:00:00Z",
  "insert_date": "2016-11-14T14:19:35Z"
}
Name Type Description Accepted values
id string Унікальний код оновлення реєстру Any
name string Назва ресурсу Any
url string Посилання на оновлений ресурс Any
file_hash_sum string Хеш сума контенту файлу Any
removed number Кількість видалених записів з реєстру Any
added number Кількість доданих записів до реєстру Any
created_at string Час оновлення даних у форматі ISO 8601 Any
Example (generated)
{
  "id": "29092018_2",
  "name": "MVSWantedTransport_1.json",
  "url": "https://data.gov.ua/dataset/9b0e87e0-eaa3-4f14-9547-03d61b70abb6/resource/06e65b06-3120-4713-8003-7905a83f95f5/revision/29092018_2",
  "file_hash_sum": "f4ae97fb62c7c9b91d6b950c79deb716",
  "removed": 27019,
  "added": 43365,
  "created_at": "2018-09-29T22:33:33Z"
}
Name Type Description Accepted values
added integer Кількість доданих записів за місяць Any
removed integer Кількість видалених записів за місяць Any
month integer Місяць Any
year integer Рік Any
Example (generated)
{
  "added": 241,
  "removed": 195,
  "month": 2,
  "year": 2020
}