Endpoints

1) Получить метаданные фильтров

GET /api/v1/vehicle-auction/vehicles/filters

Используйте этот endpoint для построения поискового интерфейса. Он возвращает списки опций, значения по умолчанию, границы диапазонов, фильтры локаций, метаданные доставки и метаданные документов продажи.

Ответ включает:

1. опции статуса лота и подстатуса аукциона
2. опции типа аукциона
3. марки и модели, сгруппированные по марке
4. типы транспортных средств
5. числовые диапазоны: цена, год, пробег, двигатель
6. дополнительные фильтры: цвет, топливо, трансмиссия, привод, состояние запуска, повреждения, цилиндры, наличие ключа
7. метаданные фильтра по дате аукциона
8. метаданные фильтра только на сегодня
9. метаданные фильтра документов продажи
10. метаданные фильтра типа продавца
11. метаданные фильтров доставки
12. фильтры локаций: штат, площадка, название офиса, zip/radius

2) Поиск автомобилей (полный payload лота)

GET /api/v1/vehicle-auction/vehicles

Возвращает список автомобилей, соответствующих фильтрам.
Каждый элемент возвращается в том же полном формате “lot payload”, что и endpoint одного автомобиля.

Примечания

• Когда zip + radius используются, ответ может содержать distance поле для каждого лота.
• Расстояние рассчитывается по координатам лота; координаты площадки используются как fallback, если они доступны.
• Фильтры документов продажи и типа продавца работают по принципу best-effort и зависят от доступных исходных данных.

3) Получить один автомобиль

GET /api/v1/vehicle-auction/vehicles/{vinOrLotNumber}

Возвращает один автомобиль в полном формате lot payload.

Основные поля ответа

• slug_vin — публичный VIN автомобиля или номер лота
• vin — VIN в верхнем регистре
• platform, platform_id, lot_number
• title, year, make, model, type
• auction — стан аукціону, розклад, buy now / timed прапорці, sold metadata
• pricing — поточна ставка, buy now price, остання ціна продажу, орієнтовний історичний діапазон
• location — відображувана локація, рекомендований порт доставки, штат
• seller — назва продавця та визначений тип
• condition — стан запуску, ключ, loss, пошкодження
• odometer — пробіг у mi/km
• vehicle_specs — двигун, трансмісія, паливо, привід, тип кузова, airbags, restraint system
• sale_document — визначена назва документа, тип, локалізований опис, export, registration, page ID, pending flag
• media — зображення, відео, 360 data
• facility — ID майданчика, штат, ZIP, координати, назва офісу
• distance — відстань від запитаного ZIP, коли використовується radius search
• details — розширений raw IAAI detail block, якщо доступний

4) Получить историю автомобиля

GET /api/v1/vehicle-auction/vehicles/{vinOrLotNumber}/history

Возвращает строки истории продаж для лота.

Ответ включает

• vehicle.slug_vin
• vehicle.vin
• vehicle.platform
• vehicle.lot_number
• history[].platform
• history[].date — форматується як Y-m-d
• history[].price
• history[].status

5) Получить похожие автомобили

GET /api/v1/vehicle-auction/vehicles/{vinOrLotNumber}/related

Возвращает похожие автомобили с той же платформы, марки и модели.
Ответ разделен на:

• source — запрошенный автомобиль
• upcoming — похожие активные или будущие автомобили
• past — похожие проданные или удаленные автомобили

6) Получить доставку для конкретного автомобиля

GET /api/v1/vehicle-auction/vehicles/{vinOrLotNumber}/shipping

Возвращает подобранные цены доставки от аукциона до порта для одного конкретного автомобиля.

Ответ включает

• vehicle — platform, lot number, VIN, title, type
• auction_location.display — зрозуміла для людини локація аукціону
• auction_location.facility_id
• auction_location.matched_location_id — ID підібраної inland shipping location
• auction_location.match_score — similarity score, який використовується для matching
• shipping.recommended_port
• shipping.recommended_price_usd
• shipping.has_shipping_price
• shipping.available_ports — список підібраних портів і цін

7) Получить доставку по VIN / номеру лота / slug

GET /shipping/auction-to-port

Возвращает цены доставки от аукциона до порта без предварительного вызова endpoint одного автомобиля.

8) Получить аукционные локации

GET /locations

Возвращает аукционные площадки / офисы и количество аукционов на сегодня.

Ответ включает

• platform
• facility_id
• name
• name_desc
• city
• state_code
• state_name
• zip
• latitude
• longitude
• location_url
• sale_day
• sale_time
• time_zone
• today_auction_count
• distance когда используется ZIP/radius search