A
Apibara
API platform
☰
Home
Our products
Copart & IAAI Vehicle Auction API YouTube Data API
Blog About us Contact us Log in Get started
API Documentation

Copart & IAAI Vehicle Auction API

Search, monitor and integrate Copart and IAAI vehicle auction data with one structured API. Get VIN records, lot details, prices, photos, auction status and sale history.
Product page Endpoints

Endpoints

1) Get filters metadata

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

Use this endpoint to build your search UI. It returns option lists, defaults, range limits, location filters, shipping-related filter metadata, and sale document filter metadata.

Response includes:

  1. lot status / sub-status options
  2. auction type options
  3. makes + models grouped by make
  4. types
  5. numeric ranges (price / year / odometer / engine)
  6. extra filters (color, fuel, transmission, drive type, running condition, damage, cylinders, has key)
  7. auction date filter metadata
  8. today-only filter metadata
  9. sale document filter metadata
  10. seller type filter metadata
  11. shipping filter metadata
  12. location filters (state, facility, office name, zip/radius)

2) Search vehicles (full lot payload)

GET /api/v1/vehicle-auction/vehicles

Returns a list of vehicles matching filters.
Each item is returned in the same full “lot payload” format as the single vehicle endpoint.

Param Type Example Description
s string 1G1BC5SM7H7259061 Search by VIN, lot number, or title
per_page integer 20 Results per page. Maximum supported value is 20
cursor string eyJpZCI6MTIzfQ== Cursor pagination token from meta.next_cursor or meta.prev_cursor
lot_status string All Lot type: All, Buy Now, Timed
lot_sub_status string Open Auction state filter: Open, Live, Ended
auction_type integer 2 Platform filter: 0 = All, 1 = Copart, 2 = IAAI
make string Toyota Vehicle make
model string Camry Vehicle model
type string Sedan Vehicle type / body category depending on dataset
price_min number 0 Minimum current bid in USD
price_max number 6500 Maximum current bid in USD
year_from integer 2015 Minimum vehicle year
year_to integer 2026 Maximum vehicle year
odometer_from integer 0 Minimum mileage in miles
odometer_to integer 250000 Maximum mileage in miles
engine_size_from number 1.6 Minimum engine size in liters
engine_size_to number 4.0 Maximum engine size in liters
engine_hp_from integer 100 Minimum engine horsepower
engine_hp_to integer 500 Maximum engine horsepower
color[] array color[]=Black&color[]=White Multi-select exterior colors
fuel_type[] array fuel_type[]=Gasoline Multi-select fuel types
transmission[] array transmission[]=Automatic Multi-select transmission types
drive_type[] array drive_type[]=AWD Multi-select drive types: AWD, FWD, RWD
run_cond string RUNS AND DRIVES Running condition. Use values returned by /api/v1/vehicle-auction/vehicles/filters
damage[] array damage[]=Water Multi-select damage groups. Use values returned by /api/v1/vehicle-auction/vehicles/filters
cylinders[] array cylinders[]=4 Multi-select cylinder counts
has_key string With Key presence filter. Supported values: With, No, All
facility_id string 136 Filter by auction facility / office ID
loc_state string FL Filter by auction facility state code
office_name string Birmingham Partial search by auction office name
zip string 33166 ZIP or postal code for nearby lot search
radius number 50 Radius around ZIP/postal code
units string mi Distance units: km or mi
auction_date_from string 2026-03-20 Start date for auction date filtering. Format: YYYY-MM-DD
auction_date_to string 2026-03-25 End date for auction date filtering. Format: YYYY-MM-DD
today_only boolean / integer 1 Return only lots scheduled for today
sale_document_pending boolean / integer 1 Return only lots with pending sale documents
sale_document_page_id integer 4 Filter by resolved sale document page ID
sale_document_type string clean Filter by resolved sale document type
seller_type string insurance Filter by inferred seller type: insurance, non_insurance, dealer, finance
has_shipping_price boolean / integer 1 Return only lots where auction-to-port shipping price could be matched

Notes

  • When zip + radius are used, the response may include a distance field for each lot.
  • Distance is calculated using lot coordinates, with facility coordinates used as a fallback when available.
  • Sale document and seller type filters are best-effort and depend on available source data.

3) Get single vehicle

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

Returns one vehicle in full lot payload format.

Param Type Example Description
vinOrLotNumber string 2HKRM4H7XEH623608or 45416833 Vehicle VIN or auction lot number used in the API. Depending on implementation it can resolve by slug/VIN or lot number

Main response fields

  • slug_vin — public Vehicle VIN or auction lot number
  • vin — VIN in uppercase
  • platform, platform_id, lot_number
  • title, year, make, model, type
  • auction — auction state, schedule, buy now / timed flags, sold metadata
  • pricing — current bid, buy now price, last sold price, estimated historical range
  • location — display location, recommended shipping port, state
  • seller — seller name and inferred type
  • condition — run condition, key, loss, damage
  • odometer — mileage in mi/km
  • vehicle_specs — engine, transmission, fuel, drive type, body style, airbags, restraint system
  • sale_document — resolved document name, type, localized description, export, registration, page ID, pending flag
  • media — images, video, 360 data
  • facility — facility ID, state, ZIP, coordinates, office name
  • distance — distance from requested ZIP when radius search is used
  • details — extended raw IAAI detail block when available

4) Get vehicle history

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

Returns sale history rows for a lot.

Param Type Example Description
vinOrLotNumber string 2HKRM4H7XEH623608or 45416833 Vehicle VIN or auction lot number
per_page integer 50 History page size
cursor string eyJpZCI6MTIzfQ== Cursor token for pagination

Response includes

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

5) Get related vehicles

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

Returns related vehicles for the same platform, make, and model.
The response is split into:

  • source — the requested vehicle
  • upcoming — related active / upcoming vehicles
  • past — related sold / removed vehicles

6) Get shipping for a specific vehicle

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

Returns matched auction-to-port shipping prices for one specific vehicle.

Param Type Example Description
vinOrLotNumber string 2HKRM4H7XEH623608or 45416833 Vehicle VIN or auction lot number
ports string Miami,NY,LA Comma-separated list of destination ports to return. If omitted, all supported ports are checked

Response includes

  • vehicle — platform, lot number, VIN, title, type
  • auction_location.display — human-readable auction location
  • auction_location.facility_id
  • auction_location.matched_location_id — matched inland shipping location ID
  • auction_location.match_score — similarity score used for matching
  • shipping.recommended_port
  • shipping.recommended_price_usd
  • shipping.has_shipping_price
  • shipping.available_ports — list of matched ports and prices

7) Get shipping by VIN / lot number / slug

GET /shipping/auction-to-port

Returns auction-to-port shipping prices without calling the single vehicle endpoint first.

Param Type Example Description
vin string 1G1BC5SM7H7259061 Vehicle VIN
lot_number string 12345678 Lot number
slug_vin string 2HKRM4H7XEH623608or 45416833 Vehicle VIN or auction lot number
ports string Miami,NY,LA Comma-separated destination ports filter

8) Get auction locations

GET /locations

Returns auction facilities / offices and today auction counts.

Param Type Example Description
platform string copart Platform filter: copart or iaai
state string FL Facility state code
facility_id string 136 Facility ID
q string Birmingham Search by office name, city, state code, or ZIP
zip string 33166 ZIP/postal code for nearby office search
radius number 50 Radius around ZIP/postal code
units string mi Distance units: km or mi
per_page integer 50 Results per page

Response includes

  • 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 when ZIP/radius search is used