Endpoints

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

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

Използвайте този endpoint, за да изградите интерфейс за търсене. Той връща списъци с опции, стойности по подразбиране, граници на диапазони, филтри за локации, метаданни за shipping филтри и метаданни за документи за продажба.

Отговорът включва:

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

2) Търсене на автомобили (пълен payload на лота)

GET /api/v1/vehicle-auction/vehicles

Връща списък с автомобили, които отговарят на филтрите.
Всеки елемент се връща в същия пълен формат “lot payload” като endpoint-а за единичен автомобил.

Бележки

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

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 — показвана локация, препоръчан shipping порт, щат
• seller — име на продавача и определен тип
• condition — състояние на работа, ключ, loss, щети
• odometer — пробег в mi/km
• vehicle_specs — двигател, трансмисия, гориво, задвижване, каросерия, airbags, restraint system
• sale_document — разпознато име на документ, тип, локализирано описание, export, registration, page ID, pending flag
• media — изображения, видео, 360 data
• facility — 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) Получаване на shipping за конкретен автомобил

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

Връща съпоставени цени за 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) Получаване на shipping по VIN / номер на лот / slug

GET /shipping/auction-to-port

Връща цени за shipping от аукцион до порт без предварително извикване на endpoint за единичен автомобил.

8) Получаване на аукционни локации

GET /locations

Връща аукционни facilities / офиси и броя аукциони за днес.

Отговорът включва:

• 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