Endpoints

1) Obține metadatele filtrelor

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

Folosește acest endpoint pentru a construi interfața de căutare. Returnează liste de opțiuni, valori implicite, limite de interval, filtre de locație, metadate pentru filtrele de shipping și metadate pentru documentele de vânzare.

Răspunsul include:

1. opțiuni pentru statusul și sub-statusul lotului
2. opțiuni pentru tipul licitației
3. mărci și modele grupate după marcă
4. tipuri de vehicule
5. intervale numerice: preț, an, odometru, motor
6. filtre suplimentare: culoare, combustibil, transmisie, tracțiune, stare de funcționare, daune, cilindri, cheie disponibilă
7. metadate pentru filtrul datei licitației
8. metadate pentru filtrul doar azi
9. metadate pentru documentele de vânzare
10. metadate pentru tipul vânzătorului
11. metadate pentru filtrele de shipping
12. filtre de locație: stat, facility, nume birou, zip/radius

2) Caută vehicule (payload complet al lotului)

GET /api/v1/vehicle-auction/vehicles

Returnează lista vehiculelor care corespund filtrelor.
Fiecare element este returnat în același format complet “lot payload” ca endpointul pentru un singur vehicul.

Note

• Când sunt folosite zip + radius, răspunsul poate include câmpul distance pentru fiecare lot.
• Distanța este calculată folosind coordonatele lotului; coordonatele facility-ului sunt folosite ca fallback când sunt disponibile.
• Filtrele pentru documentele de vânzare și tipul vânzătorului sunt best-effort și depind de datele sursă disponibile.

3) Obține un singur vehicul

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

Returnează un vehicul în format complet lot payload.

Câmpuri principale ale răspunsului

• slug_vin — identificator public al vehiculului
• vin — VIN cu litere mari
• platform, platform_id, lot_number
• title, year, make, model, type
• auction — starea licitației, program, flaguri buy now / timed, sold metadata
• pricing — ofertă curentă, buy now price, ultimul preț de vânzare, interval istoric estimat
• location — locație afișată, port recomandat pentru shipping, stat
• seller — numele vânzătorului și tipul dedus
• condition — stare de funcționare, cheie, loss, daune
• odometer — kilometraj în mi/km
• vehicle_specs — motor, transmisie, combustibil, tracțiune, caroserie, airbags, restraint system
• sale_document — nume document rezolvat, tip, descriere localizată, export, registration, page ID, pending flag
• media — imagini, video, 360 data
• facility — ID facility, stat, ZIP, coordonate, nume birou
• distance — distanța față de ZIP-ul solicitat când se folosește radius search
• details — bloc raw IAAI extins, când este disponibil

4) Obține istoricul vehiculului

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

Returnează rândurile istoricului de vânzări pentru un lot.

Răspunsul include:

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

5) Obține vehicule similare

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

Returnează vehicule similare pentru aceeași platformă, marcă și model.
Răspunsul este împărțit în:

• source — vehiculul solicitat
• upcoming — vehicule similare active sau viitoare
• past — vehicule similare vândute sau eliminate

6) Obține shipping pentru un vehicul specific

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

Returnează prețuri potrivite pentru shipping de la licitație la port pentru un vehicul specific.

Răspunsul include:

• vehicle — platform, lot number, VIN, title, type
• auction_location.display — locație de licitație ușor de citit
• auction_location.facility_id
• auction_location.matched_location_id — ID-ul locației inland shipping potrivite
• auction_location.match_score — similarity score folosit pentru matching
• shipping.recommended_port
• shipping.recommended_price_usd
• shipping.has_shipping_price
• shipping.available_ports — lista porturilor și prețurilor potrivite

7) Obține shipping după VIN / număr lot / slug

GET /shipping/auction-to-port

Returnează prețuri de shipping de la licitație la port fără a apela mai întâi endpointul pentru un singur vehicul.

8) Obține locațiile de licitație

GET /locations

Returnează facility-uri / birouri de licitație și numărul de licitații de azi.

Răspunsul include:

• 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 când este folosit ZIP/radius search