List auction vehicles
Search and incrementally synchronize normalized Copart and IAAI inventory. Filters are cumulative. Applied filters are echoed in meta.applied_filters; unrecognized query keys are reported in meta.unknown_filters. Use include_total=true only when an exact reconciliation count is required.
Request
- Base URL: https://apibara.tech/api/v1/vehicle-auction
- URL: https://apibara.tech/api/v1/vehicle-auction/vehicles
- Auth: API key in header X-API-Key
Query parameters
Search by lot number, VIN, or vehicle title.
Lot status filter.
Normalized lot sub-status. Open = active/open and not sold; Live = currently live when supported; Ended = ended/closed state.
Upcoming selector. all = no restriction; only = only upcoming eligible lots; without = exclude upcoming lots. This does not override Open/Sold state logic.
Return records whose updated_at changed within the requested number of minutes. Designed for incremental synchronization; combine with cursor pagination and auction filters.
Minimum price.
Maximum price.
Minimum vehicle year.
Maximum vehicle year.
Numeric auction platform filter: 0 = all supported platforms, 1 = Copart, 2 = IAAI. Use either auction_type or platform in the same request.
Readable auction platform filter. Use copart or iaai. Use either platform or auction_type in the same request.
Vehicle type. Multiple values are OR-ed; query-array syntax such as type[]=COUPE&type[]=AUTOMOBILE is supported.
Filter by vehicle_specs.body_style. Multiple values are OR-ed. Query-array syntax is supported, for example body_style[]=Coupe&body_style[]=Convertible. IAAI uses its VehicleClass value; Copart uses the source-backed Body Style field.
Compatibility alias for body_style. Multiple values are OR-ed. Prefer body_style for new integrations.
Vehicle make.
Canonical vehicle series / model family. Examples: BMW Series 3, Mercedes-Benz C-Class, Toyota Camry, Audi A4, Ford F-150. Optional; can be combined with model and generation filters.
Vehicle model.
Vehicle generation catalog ID. Use /vehicles/filters?make=BMW&model=X5 to discover valid IDs. Multiple IDs are supported.
Human-readable generation alias, for example F15, E70 or G05. generation_id is preferred for stable integrations.
Vehicle color. Multiple values are supported.
Fuel type. Multiple values are supported.
Minimum odometer value.
Maximum odometer value.
Minimum engine size.
Maximum engine size.
Engine layout. I=inline, V=V engine, W=W engine, B/H=boxer/horizontally opposed. Scalar and repeated-array forms are supported.
Transmission type. Multiple values are supported.
Number of cylinders. Multiple values are supported.
Drive type. Multiple values are supported.
Run condition.
Damage type. Multiple values are supported.
Filter vehicles by key availability.
Cursor for pagination.
ZIP code for location-based search.
Search radius around ZIP.
Distance units.
Records per vehicle-search page. Default 20. The effective maximum is plan-dependent; public plan entitlements can use maxima of 20, 30 or 40, while approved custom plans may differ. Use the active account entitlement as the runtime source of truth.
When true, meta.total contains an exact filtered count. Counts are cached briefly; omit this parameter for the lowest-latency cursor synchronization path.
Auction facility ID.
Auction facility state/region code. Accepts a scalar or repeated/form-style array, e.g. loc_state=FL or loc_state[]=FL.
Auction office or branch name.
Auction date from.
Auction date to.
Return only vehicles with auctions today.
Filter by pending sale document.
Sale document type.
Seller type.
Return only vehicles with shipping price data.
Response
Paginated list of vehicle auction records.
Example response
{
"data": [
{
"platform": "iaai",
"lot_number": "45416833",
"vin": "2HKRM4H7XEH623608",
"title": "2014 HONDA CR-V EX-L",
"year": 2014,
"make": "HONDA",
"model": "CR-V",
"series": {
"key": "SERIES3",
"name": "Series 3"
},
"generation": {
"id": 379,
"name": "F15",
"generation": "F15",
"make": "BMW",
"model": "X5",
"year_from": 2013,
"year_to": 2018,
"label": "F15 (2013–2018)"
},
"type": "AUTOMOBILE",
"color": "Black",
"fuel_type": "Gasoline",
"transmission": "Automatic",
"drive_type": "AWD",
"odometer": {
"mi": 120000,
"km": 193121
},
"damage": "Mechanical",
"auction": {
"state": "open",
"auction_at": "2026-06-22T13:30:00+00:00",
"lot_status": "Timed",
"lot_sub_status": "Open"
},
"pricing": {
"estimated_cost": {
"text": "$4,900 - $8,500"
}
},
"location": {
"display": "Englishtown (NJ)",
"state": "NJ",
"facility_id": "136"
},
"vin_lots": [
{
"auction": {
"state": "open",
"auction_at": "2026-06-22T13:30:00+00:00",
"lot_status": "Timed",
"lot_sub_status": "Open"
},
"pricing": {
"estimated_cost": {
"text": "$4,900 - $8,500"
}
}
}
],
"vehicle_specs": {
"body_style": "Coupe"
}
}
],
"meta": {
"per_page": 20,
"next_cursor": "eyJ2ZWhpY2xlcy5hZCI6IjIwMjYtMDctMTMgMTY6MzA6MDAiLCJ2ZWhpY2xlcy51cGRhdGVkX2F0IjoiMjAyNi0wNy0xMSAwODowOToyOSIsIl9wb2ludHNUb05leHRJdGVtcyI6dHJ1ZX0"
}
}Changes
No recorded changes to this operation across all 1 revision of this API.