# Copart Lot

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/copart/lot` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 2 credits per call |
| **Documentation** | https://www.piloterr.com/library/copart-lot |

## Description

Copart Lot API: retrieve structured auction lot data by lot number or URL. Specs, damage, bids, photos, yard location and sale status across regional Copart sites.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/copart/lot' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Lot 55295666 on copart.co.uk

```json
{
  "id": "55295666",
  "lic": [
    "ADDL-INFO",
    "CERT-D",
    "IV",
    "VHDRP"
  ],
  "url": "https://www.copart.co.uk/lot/55295666/clean-title-2014-porsche-panamera-4-8-v8-gts-4dr-pdk-sandy",
  "fuel": "PETROL",
  "keys": "YES",
  "make": "PORSCHE",
  "year": 2014,
  "color": "GREY",
  "drive": "2 AXLE RIGID BODY",
  "model": "PANAMERA G",
  "title": "2014 PORSCHE PANAMERA 4.8 V8 GTS 4DR PDK",
  "engine": "4806 cc",
  "images": [
    "https://cs.copart.com/v1/AUTH_svc.pdoc00001/lpp/0626/7834e4c0e5da4ef3809e87b2e31a987d_thb.jpg"
  ],
  "currency": "GBP",
  "latitude": 52.14,
  "lot_sold": false,
  "odometer": 74190,
  "image_url": "https://cs.copart.com/v1/AUTH_svc.pdoc00001/lpp/0626/7834e4c0e5da4ef3809e87b2e31a987d_thb.jpg",
  "longitude": -0.3,
  "sale_date": "2026-07-01T09:00:00+00:00",
  "yard_city": "SANDY",
  "yard_name": "SANDY",
  "bid_status": "NEVER_BID",
  "buy_it_now": true,
  "run_status": "RUNS AND DRIVES",
  "title_code": "U - Used Unrecorded",
  "yard_state": "GB",
  "current_bid": 4100,
  "model_group": "PANAMERA",
  "sale_status": "MINIMUM_BID",
  "vin_partial": "*****************",
  "yard_number": 401,
  "last_updated": "2026-06-30T13:12:15+00:00",
  "title_status": "CLEAN TITLE",
  "transmission": "7 SPEED S-AUTO",
  "vehicle_type": "VEHICLES UNDER 7.5 TONNES",
  "yard_country": "GBR",
  "primary_damage": "FRONT END",
  "buy_it_now_price": 0,
  "secondary_damage": "PREVIOUS REPAIR"
}
```

## Documentation

## Overview
The **Copart Lot API** returns structured data for a single Copart auction lot from a **lot number** or **full lot URL**: make, model, year, damage, photos, current bid, title status, yard location, and sale schedule.

Built for developers integrating Copart lot data into apps, dashboards, and automation, without maintaining regional scrapers.

Use **Copart Search** to discover lots. For richer listing copy and commercial use cases, see **Copart Ad**.

## Supported regions
| Code | Site | Currency |
|---|---|---|
| `us` (default) | www.copart.com | USD |
| `ca` | www.copart.ca | CAD |
| `uk` | www.copart.co.uk | GBP |
| `ie` | www.copart.ie | EUR |
| `mea` / `ae` / `bh` / `om` | www.copartmea.com | AED |
| `de` | www.copart.de | EUR |
| `es` | www.copart.es | EUR |
| `fi` | www.copart.fi | EUR |
| `br` | www.copart.com.br | BRL |

## Quickstart
```
GET https://api.piloterr.com/v2/copart/lot?query=55295666&region=uk
GET https://api.piloterr.com/v2/copart/lot?query=https://www.copart.co.uk/lot/55295666/clean-title-2014-porsche-panamera-4-8-v8-gts-4dr-pdk-sandy
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Lot number or full Copart lot URL |
| `region` | string | no | Region code when `query` is a lot number only (default: US) |
| `return_page_source` | boolean | no | Raw HTML instead of JSON (default: `false`) |

## Response
Flat JSON with vehicle specs, pricing, damage, images, yard info, sale status, and more. Key fields include `id`, `make`, `model`, `year`, `primary_damage`, `current_bid`, `sale_status`, `images`, `yard_name`, `run_status`, and `title_status`. See the example response for the full schema.

## Typical integrations
- Enrich search results with full lot metadata in your UI
- Poll bid and sale status for auction monitoring tools
- Sync yard inventory into internal databases
- Export raw HTML via `return_page_source` when structured JSON is not enough

Costs **2 credits** per call.