# Copart Lot Filters API Documentation

<p><strong>Copart Lot Filters API Documentation</strong> 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.</p>

- **Documentation:** [https://scrappa.co/docs/copart-api/copart_lot_filters](https://scrappa.co/docs/copart-api/copart_lot_filters)
- **API group:** Copart API
- **Endpoint:** `GET https://scrappa.co/api/copart/lots/filters`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `make` | string | No | Vehicle make, e.g. TOYOTA. Case does not matter. |
| `model` | string | No | Vehicle model, e.g. CIVIC. Case does not matter. |
| `year_from` | integer | No | Lowest model year, 1900 to 2100, e.g. 2018. |
| `year_to` | integer | No | Highest model year, 1900 to 2100, e.g. 2022. Must not be below year_from. |
| `damage` | string | No | 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. |
| `title_group` | string | No | One-letter title group code, e.g. C (clean title). Read the exact codes from the filters endpoint. |
| `yard` | string | No | Copart yard name, e.g. TX - DALLAS. Read the exact names from the filters endpoint. |
| `odometer_max` | integer | No | Highest odometer reading, 0 to 1000000, e.g. 25000. |
| `buy_it_now` | boolean | No | Set to true to list only lots with a buy it now price. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 502 | Invalid Source Response | Copart answered with an unexpected response. This response is not billable. |
| 503 | Service Unavailable | The upstream service is temporarily unavailable. Please retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)