Copart Lot Search API Documentation Search public Copart salvage auction lots by free text and filters: make, model, model year range, damage code, title group, yard, odometer limit and buy it now. Each lot has the lot number, vehicle data, masked VIN, damage, title, condition, odometer with unit, current bid, estimated retail value, buy it now price, auction date (ISO 8601, UTC), yard location, thumbnail and the public lot url. Lots can be in the US or Canada: read the currency and odometer unit on each lot. Page with page and per_page (up to 100); has_more and next_page tell you when to continue. A search without hits is a successful response with an empty lots array.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
12 optional filters available.
string
Optional
Free-text search over lots, e.g. civic. Omit to list all lots.
coffee shops
string
Optional
Vehicle make, e.g. TOYOTA. Case does not matter.
example
string
Optional
Vehicle model, e.g. CIVIC. Case does not matter.
example
integer
Optional
Lowest model year, 1900 to 2100, e.g. 2018.
10
integer
Optional
Highest model year, 1900 to 2100, e.g. 2022. Must not be below year_from.
10
string
Optional
Two-letter primary damage code, e.g. AO (all over). Codes: FR front end, RR rear end, SD side, AO all over, HL hail, BN burn, FD flood, BC biohazard or chemical.
example
string
Optional
One-letter title group code, e.g. C (clean title). Read the exact codes from the filters endpoint.
example
string
Optional
Copart yard name, e.g. TX - DALLAS. Read the exact names from the filters endpoint.
example
integer
Optional
Highest odometer reading, 0 to 1000000, e.g. 25000.
10
boolean
Optional
Set to true to list only lots with a buy it now price.
true
integer
Optional
1-based page number. Defaults to 1.
1
integer
Optional
Lots per page, 1 to 100. Defaults to 20.
10
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"lots": [
{
"url": "https://www.copart.com/lot/41979656/clean-title-2010-honda-civic-dx-g-4dr-on-ottawa",
"zip": "K1G 6Y7",
"city": "OTTAWA",
"make": "HONDA",
"yard": "ON - OTTAWA",
"year": 2010,
"color": "BLUE",
"model": "CIVIC DX-G 4DR",
"state": "ON",
"country": "CAN",
"currency": "CAD",
"has_keys": true,
"latitude": 45.30481,
"odometer": 104298,
"timezone": "EDT",
"condition": "RUNS AND DRIVES",
"longitude": -75.55097,
"bid_status": "NEVER_BID",
"lot_number": 41979656,
"title_type": "CLEAN TITLE",
"vin_masked": "2HGFA1F49AH******",
"current_bid": 600,
"description": "2010 HONDA CIVIC DX-G 4DR",
"sale_status": "PURE_SALE",
"title_state": "ON",
"auction_date": "2026-10-15T14:00:00Z",
"transmission": "AUTOMATIC",
"odometer_unit": "km",
"thumbnail_url": "https://cs.copart.com/v1/AUTH_svc.pdoc00001/lpp/0426/62cbb210444543f1bb8f80a986cfdd7b_thb.jpg",
"primary_damage": "FRONT END",
"odometer_status": "EXEMPT",
"secondary_damage": "SIDE",
"estimated_retail_value": 6529.56
},
{
"url": "https://www.copart.com/lot/51416926/2026-honda-civic-sport-ny-newburgh",
"zip": "12542",
"city": "MARLBORO",
"fuel": "ELECTRIC AND GAS HYBRID",
"make": "HONDA",
"yard": "NY - NEWBURGH",
"year": 2026,
"color": "BLACK",
"drive": "FRONT WHEEL DRIVE",
"model": "CIVIC",
"state": "NY",
"engine": "2.0L 4",
"country": "USA",
"currency": "USD",
"has_keys": true,
"latitude": 41.62152,
"odometer": 2910,
"timezone": "EDT",
"condition": "RUNS AND DRIVES",
"cylinders": 4,
"longitude": -73.95766,
"bid_status": "NEVER_BID",
"body_style": "SEDAN",
"lot_number": 51416926,
"title_type": "NON-REPAIRABLE",
"vin_masked": "2HGFE4F89TH******",
"current_bid": 450,
"description": "2026 HONDA CIVIC SPORT",
"sale_status": "ON_APPROVAL",
"title_state": "WI",
"auction_date": "2026-10-15T14:00:00Z",
"transmission": "AUTOMATIC",
"odometer_unit": "miles",
"thumbnail_url": "https://cs.copart.com/v1/AUTH_svc.pdoc00001/lpp/0426/59f8738f6c444b1d9651625c7a5a5155_thb.jpg",
"primary_damage": "FRONT END",
"odometer_status": "ACTUAL",
"secondary_damage": "SIDE",
"estimated_retail_value": 27187
}
],
"page": 1,
"total": 10178,
"has_more": true,
"per_page": 2,
"next_page": 2
},
"meta": {
"billable": true,
"endpoint_family": "lot_search"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A query parameter is missing or invalid. This response is not billable.
{
"errors": {
"per_page": [
"The per page must be 100 or fewer lots."
]
},
"message": "The request validation failed"
}Invalid Source Response
Copart answered with an unexpected response. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "lot_search"
},
"error": {
"code": "PARSER_DRIFT",
"message": "Copart answered with an unexpected response. Please retry later."
},
"success": false
}Service Unavailable
The upstream service is temporarily unavailable. Please retry shortly.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "lot_search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "The Copart API is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.