Endpoints

1) Pobierz metadane filtrów

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

Użyj tego endpointu do zbudowania interfejsu wyszukiwania. Zwraca listy opcji, wartości domyślne, limity zakresów, filtry lokalizacji, metadane dostawy oraz metadane dokumentów sprzedaży.

Odpowiedź zawiera:

1. opcje statusu i podstatusu lotu
2. opcje typu aukcji
3. marki i modele pogrupowane według marki
4. typy pojazdów
5. zakresy liczbowe: cena, rok, przebieg, silnik
6. dodatkowe filtry: kolor, paliwo, skrzynia biegów, napęd, stan uruchomienia, uszkodzenia, cylindry, kluczyk
7. metadane filtra daty aukcji
8. metadane filtra tylko na dziś
9. metadane dokumentów sprzedaży
10. metadane typu sprzedawcy
11. metadane filtrów dostawy
12. filtry lokalizacji: stan, plac, nazwa biura, zip/radius

2) Wyszukaj pojazdy (pełny payload lotu)

GET /api/v1/vehicle-auction/vehicles

Zwraca listę pojazdów pasujących do filtrów.
Każdy element jest zwracany w tym samym pełnym formacie “lot payload” co endpoint pojedynczego pojazdu.

Uwagi

• Gdy zip + radius są używane, odpowiedź może zawierać distance pole dla każdego lotu.
• Odległość jest obliczana na podstawie współrzędnych lotu; współrzędne placu są używane jako fallback, jeśli są dostępne.
• Filtry dokumentów sprzedaży i typu sprzedawcy działają w trybie best-effort i zależą od dostępnych danych źródłowych.

3) Pobierz pojedynczy pojazd

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

Zwraca jeden pojazd w pełnym formacie lot payload.

Główne pola odpowiedzi

• slug_vin — publiczny VIN pojazdu lub numer lotu aukcyjnego
• vin — VIN wielkimi literami
• platform, platform_id, lot_number
• title, year, make, model, type
• auction — stan aukcji, harmonogram, flagi buy now / timed, sold metadata
• pricing — aktualna oferta, buy now price, ostatnia cena sprzedaży, szacowany zakres historyczny
• location — wyświetlana lokalizacja, rekomendowany port dostawy, stan
• seller — nazwa sprzedawcy i rozpoznany typ
• condition — stan uruchomienia, kluczyk, loss, uszkodzenia
• odometer — przebieg w mi/km
• vehicle_specs — silnik, skrzynia biegów, paliwo, napęd, typ nadwozia, airbags, restraint system
• sale_document — rozpoznana nazwa dokumentu, typ, opis lokalny, export, registration, page ID, pending flag
• media — zdjęcia, wideo, 360 data
• facility — ID placu, stan, ZIP, współrzędne, nazwa biura
• distance — odległość od podanego ZIP przy radius search
• details — rozszerzony raw IAAI detail block, jeśli dostępny

4) Pobierz historię pojazdu

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

Zwraca wiersze historii sprzedaży dla lotu.

Odpowiedź zawiera

• vehicle.slug_vin
• vehicle.vin
• vehicle.platform
• vehicle.lot_number
• history[].platform
• history[].date — formatowane jako Y-m-d
• history[].price
• history[].status

5) Pobierz podobne pojazdy

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

Zwraca podobne pojazdy z tej samej platformy, marki i modelu.
Odpowiedź jest podzielona na:

• source — żądany pojazd
• upcoming — podobne aktywne lub nadchodzące pojazdy
• past — podobne sprzedane lub usunięte pojazdy

6) Pobierz dostawę dla konkretnego pojazdu

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

Zwraca dopasowane ceny dostawy z aukcji do portu dla jednego konkretnego pojazdu.

Odpowiedź zawiera

• vehicle — platforma, numer lotu, VIN, tytuł, typ
• auction_location.display — czytelna lokalizacja aukcji
• auction_location.facility_id
• auction_location.matched_location_id — ID dopasowanej inland shipping location
• auction_location.match_score — similarity score używany do matching
• shipping.recommended_port
• shipping.recommended_price_usd
• shipping.has_shipping_price
• shipping.available_ports — lista dopasowanych portów i cen

7) Pobierz dostawę po VIN / numerze lotu / slug

GET /shipping/auction-to-port

Zwraca ceny dostawy z aukcji do portu bez wcześniejszego wywołania endpointu pojedynczego pojazdu.

8) Pobierz lokalizacje aukcji

GET /locations

Zwraca place aukcyjne / biura oraz dzisiejszą liczbę aukcji.

Odpowiedź zawiera

• 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 gdy używany jest ZIP/radius search