Search auction vehicles
search_auction_vehiclesUse for broad inventory discovery, filtering and incremental synchronization across supported Copart and IAA / IAAI records. For one known VIN or lot use get_vehicle; for retained auction appearances use get_vehicle_history.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_auction_vehicles"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| s | No | Search by VIN, lot number or vehicle title/model text. | |
| zip | No | ZIP/postal code used with radius for supported proximity search. | |
| make | No | Make filter for GET /vehicles. | |
| sort | No | Sort listings filter for GET /vehicles. | |
| type | No | Vehicle type filter for GET /vehicles. | |
| color | No | Color filter for GET /vehicles. | |
| model | No | Model filter for GET /vehicles. | |
| units | No | Geographic distance unit system: mi or km. Odometer filter boundaries are always miles. | |
| cursor | No | Opaque pagination cursor returned by the API. Send next_cursor back unchanged; do not decode or synthesize it. | |
| damage | No | Primary damage category filter. | |
| radius | No | Search radius around zip, interpreted using the selected units. | |
| series | No | Series / model family filter for GET /vehicles. | |
| has_key | No | Key-availability filter using the documented values No, All or With. | |
| year_to | No | Year to filter for GET /vehicles. | |
| per_page | No | Requested page size. Effective maximum is subscription-plan dependent; common public plan limits are 20, 30 or 40 and custom plans may differ. | |
| platform | No | Readable auction-source selector: copart or iaai. Omit for combined supported sources. | |
| run_cond | No | Normalized run-condition filter. | |
| upcoming | No | Upcoming selector: all=no upcoming restriction, only=upcoming eligible lots only, without=exclude upcoming lots. | |
| body_type | No | Deprecated compatibility alias for body_style. A string or array is accepted; prefer body_style for new integrations. | |
| cylinders | No | Cylinders filter for GET /vehicles. | |
| fuel_type | No | Fuel type filter for GET /vehicles. | |
| loc_state | No | Auction location state or region, for example FL. | |
| price_max | No | Price max filter for GET /vehicles. | |
| price_min | No | Price min filter for GET /vehicles. | |
| year_from | No | Year from filter for GET /vehicles. | |
| body_style | No | Filter by vehicle_specs.body_style. A string or array is accepted; multiple values are OR-ed. IAAI uses VehicleClass and Copart uses the source-backed Body Style field. | |
| drive_type | No | Drive type filter for GET /vehicles. | |
| generation | No | Generation filter for GET /vehicles. | |
| lot_status | No | Auction mode filter: All, Timed or Buy Now. | |
| today_only | No | When true, restrict results to the endpoint current-day auction logic. | |
| vin_prefix | No | VIN prefix(es) filter for GET /vehicles. | |
| engine_type | No | Engine type filter for GET /vehicles. | |
| facility_id | No | Auction facility identifier used to restrict results to one supported facility. | |
| odometer_to | No | Odometer to (miles) filter for GET /vehicles. | |
| office_name | No | Auction office or branch name filter. | |
| seller_type | No | Normalized seller type: dealer, finance, insurance or non_insurance. | |
| auction_type | No | Numeric compatibility source selector: 0=all, 1=Copart, 2=IAAI. If both auction_type and platform are supplied, auction_type takes precedence; prefer platform for new integrations. | |
| transmission | No | Transmission filter for GET /vehicles. | |
| generation_id | No | Generation ID filter for GET /vehicles. | |
| include_total | No | Include exact total filter for GET /vehicles. | |
| odometer_from | No | Odometer from (miles) filter for GET /vehicles. | |
| engine_size_to | No | Engine size to filter for GET /vehicles. | |
| lot_sub_status | No | Normalized auction state: Open for active/open lots, Live for currently live supported lots, Ended for closed/ended lots. | |
| auction_date_to | No | End auction date in YYYY-MM-DD format. | |
| engine_size_from | No | Engine size from filter for GET /vehicles. | |
| auction_date_from | No | Start auction date in YYYY-MM-DD format. | |
| has_shipping_price | No | When true, return only vehicles with supported shipping-price data. | |
| sale_document_name | No | Sale document name (exact) filter for GET /vehicles. | |
| sale_document_type | No | Sale/title document type filter; values are source-backed and can vary. | |
| auction_date_pending | No | Auction date pending filter for GET /vehicles. | |
| sale_document_pending | No | When true, restrict results to records with a pending sale document state when supported. | |
| updated_within_minutes | No | Incremental-sync window. Return records whose updated_at changed within this many minutes; supported range is 1..525600. Use with cursor pagination and an overlap window. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| meta | No | Pagination metadata. Treat cursor values as opaque. |