# Copart Ad

## Overview

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

## Description

Copart Ad API: extract full Copart auction listing data by lot number or URL. VIN, damage, photos, bids, title status and sale info 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/ad' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Lot 74812390: 2019 Toyota Camry XSE (US)

```json
{
  "id": "74812390",
  "url": "https://www.copart.com/lot/74812390/2019-toyota-camry-xse-ca",
  "vin": "4T1B11HK5KU748120",
  "make": "TOYOTA",
  "year": 2019,
  "model": "CAMRY",
  "title": "2019 TOYOTA CAMRY XSE",
  "images": [
    "https://cs.copart.com/v1/AUTH_svc.pdoc00001/lpp/0426/74812390_ful.jpg",
    "https://cs.copart.com/v1/AUTH_svc.pdoc00001/lpp/0426/74812390_f2_ful.jpg"
  ],
  "currency": "USD",
  "location": "CA - SAN DIEGO",
  "odometer": 48320,
  "image_url": "https://cs.copart.com/v1/AUTH_svc.pdoc00001/lpp/0426/74812390_ful.jpg",
  "run_status": "RUN AND DRIVE VERIFIED",
  "current_bid": 7200,
  "sale_status": "CURRENT",
  "auction_date": "2026-05-06T15:00:00.000Z",
  "title_status": "SALVAGE CERTIFICATE",
  "primary_damage": "FRONT END"
}
```

## Documentation

## Overview
The **Copart Ad API** extracts full vehicle listing data from [Copart](https://www.copart.com) auction pages: VIN, damage report, photos, current bid, title status, yard location, and sale history.

Ideal for insurance adjusters, salvage buyers, and dealers who need structured lot data without scraping Copart themselves.

Use **Copart Search** to discover lots, then **Copart Ad** for the full listing. For a lighter technical endpoint, see **Copart Lot**.

## 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/ad?query=74812390
GET https://api.piloterr.com/v2/copart/ad?query=55295666&region=uk
GET https://api.piloterr.com/v2/copart/ad?query=https://www.copart.com/lot/74812390/2019-toyota-camry-xse-ca
```

## 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
Returns a flat JSON object with vehicle specs, pricing, damage, images, yard info, sale status, and more.

## Main use cases
- Pull condition reports and photo galleries before bidding
- Monitor bid changes and Buy It Now prices
- Build VIN history archives for valuation workflows
- Feed insurance and salvage analytics pipelines

Costs **2 credits** per call.