docs / copart

Copart API

base /copart/v14 endpoints

post/copart/v1/search1 credit

Search live Copart auction lots by free-text `query` and/or structured filters (make, model, year or year_min/year_max, title_type, vehicle_type, damage, condition, source, odometer_min/max, yard_number). Sortable + paginated. Returns rich lot cards with damage, title, odometer, estimated value, current bid, sale date, location and thumbnail.

Parameter		Allowed / range	Description
query	optional	—	Free-text keyword to search lots (make, model, VIN fragment, anything). Leave empty to browse all lots and rely on filters.
make	optional	—	Vehicle make to filter by (e.g. HONDA, FORD, BMW). Case-insensitive.
model	optional	—	Vehicle model to filter by (e.g. CIVIC, F-150). Pair with `make`.
year	optional	1900–2030	Exact model year. For a range use year_min / year_max instead.
year_min	optional	1900–2030	Minimum model year (inclusive). Combine with year_max.
year_max	optional	1900–2030	Maximum model year (inclusive). Combine with year_min.
title_type	optional	clean · salvage · non_repairable	Filter by title brand.
vehicle_type	optional	automobile · motorcycle · atv · boat · bus · construction · trailer · heavy_truck · rv	Filter by vehicle category.
damage	optional	front_end · rear_end · side · all_over · rollover · top_roof · undercarriage · water_flood · hail · burn · burn_engine · burn_interior · vandalism · mechanical · normal_wear · minor_dents · stripped · biohazard · damage_history	Filter by primary damage type.
condition	optional	run_and_drive · enhanced · engine_start · buy_it_now · used	Filter by lot condition / sale type.
source	optional	donations · impound · repossessions	Filter by lot source / seller type.
odometer_min	optional	0–	Minimum odometer reading (miles).
odometer_max	optional	0–	Maximum odometer reading (miles).
yard_number	optional	—	Restrict to one Copart yard/location by its yard number.
location	optional	—	Restrict to one Copart yard/location by name (e.g. 'TX - DALLAS', 'CA - VAN NUYS'). Get the exact names + lot counts from the `yards` action.
sort = newest_listed	optional	newest_listed · sale_date_asc · sale_date_desc · year_desc · year_asc · odometer_asc · odometer_desc · make_az	Result ordering.
page = 1	optional	1–	Page number (1-based; 1, 2, 3 …).
size = 20	optional	1–100	Results per page (1–100). Defaults to 20.

Try in playground →

post/copart/v1/lot_detail1 credit

Full detail for one lot by `lot_number`: VIN (publicly masked by Copart), make, model, trim, year, primary/secondary damage, title type & group, odometer, color, engine, fuel, drive, transmission, estimated retail value, current/high bid, sale date & time, yard location (city/state/zip/lat/long) and keys availability.

Parameter		Allowed / range	Description
lot_number	required	—	Copart lot number — the digits in a copart.com/lot/ URL or a search result's lot_number.

Try in playground →

post/copart/v1/lot_images1 credit

All auction photos for one lot by `lot_number`: ordered full-size, hi-res and thumbnail image URLs for the vehicle (exterior, interior, damage, VIN plate, odometer).

Parameter		Allowed / range	Description
lot_number	required	—	Copart lot number to fetch photos for.

Try in playground →

post/copart/v1/yards1 credit

Live list of Copart yards / locations you can filter `search` by, each with its yard_number and current lot count. Lifted from the live search facet taxonomy — use a yard_number with search's `yard_number` filter to scope to one location.

Parameter		Allowed / range	Description
query	optional	—	Optional name filter (case-insensitive substring) to find a yard, e.g. 'dallas', 'ca -', 'houston'.

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/copart/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"make":"HONDA","size":20}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}