Copart Lot Filters API Documentation List the filter groups that Copart offers for lot search (for example make, model, year, damage, title type, fuel, yard and sale date). Each group has a code, a name and its values; each value has the raw filter value, a readable label and the number of lots. Pass the same typed filters as the search endpoint to narrow the counts. Groups and values without lots are left out.
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.
9 optional filters available.
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
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"total": 48380,
"filters": [
{
"code": "TITL",
"name": "Title Type",
"values": [
{
"count": 3934,
"label": "Clean Title",
"value": "title_group_code:TITLEGROUP_C"
},
{
"count": 511,
"label": "Non Repairable",
"value": "title_group_code:TITLEGROUP_J"
},
{
"count": 13599,
"label": "Salvage Title",
"value": "title_group_code:TITLEGROUP_S"
}
]
},
{
"code": "YEAR",
"name": "Year",
"values": [
{
"count": 7,
"label": "2027",
"value": "lot_year:\"2027\""
},
{
"count": 1851,
"label": "2026",
"value": "lot_year:\"2026\""
},
{
"count": 2399,
"label": "2025",
"value": "lot_year:\"2025\""
},
{
"count": 2216,
"label": "2024",
"value": "lot_year:\"2024\""
}
]
},
{
"code": "PRID",
"name": "Damage",
"values": [
{
"count": 260,
"label": "All Over",
"value": "damage_type_code:DAMAGECODE_AO"
},
{
"count": 34,
"label": "Biohazard/Chemical",
"value": "damage_type_code:DAMAGECODE_BC"
},
{
"count": 83,
"label": "Burn",
"value": "damage_type_code:DAMAGECODE_BN"
},
{
"count": 16,
"label": "Burn - Engine",
"value": "damage_type_code:DAMAGECODE_BE"
}
]
},
{
"code": "FUEL",
"name": "Fuel Type",
"values": [
{
"count": 103,
"label": "Electric",
"value": "fuel_type_desc:\"ELECTRIC\""
},
{
"count": 8378,
"label": "Electric And Gas Hybrid",
"value": "fuel_type_desc:\"ELECTRIC AND GAS HYBRID\""
}
]
}
]
},
"meta": {
"billable": true,
"endpoint_family": "lot_filters"
},
"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": {
"year_from": [
"The year_from must not be greater than year_to."
]
},
"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_filters"
},
"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_filters"
},
"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.