Endpoints

1) Get filters metadata

GET /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:

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

2) Search vehicles (full lot payload)

GET /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 `/vehicles/filters`
`damage[]`	array	`damage[]=Water`	Multi-select damage groups. Use values returned by `/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 /vehicles/{VIN or Lot number}

Returns one vehicle in full lot payload format.

Param	Type	Example	Description
`VIN or Lot number`	string	`5NPE34AFXHH478772` or `44922515`	Vehicle identifier used in the API. Depending on implementation it can resolve by VIN or lot number

Main response fields

slug_vin — public vehicle identifier
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 /vehicles/{slugVin}/history

Returns sale history rows for a lot.

Param	Type	Example	Description
`slugVin`	string	`2021-bmw-x5-5UXCR6C02M9D12345`	Vehicle identifier
`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 /vehicles/{slugVin}/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 /vehicles/{slugVin}/shipping

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

Param	Type	Example	Description
`slugVin`	string	`2021-bmw-x5-5UXCR6C02M9D12345`	Vehicle identifier
`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	`2021-bmw-x5-5UXCR6C02M9D12345`	Vehicle identifier
`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