# Bring a Trailer Listing API Documentation

Retrieve the full detail record of one Bring a Trailer auction by ID or slug: title, year, make, model, era, origin, category, location, the typed essentials (location, chassis/VIN where public, mileage with unit, engine, transmission, colors, wheels, other equipment, seller), the lot number, the seller type, the bid with current amount, count and end time as ISO 8601 UTC, views, watchers, comments count, gallery images with large and small variants, the closing history event with buyer and seller usernames, the buyer fees and the reserve state.

- **Documentation:** [https://scrappa.co/docs/bring-a-trailer-api/bring_a_trailer_listing](https://scrappa.co/docs/bring-a-trailer-api/bring_a_trailer_listing)
- **API group:** Bring a Trailer API
- **Endpoint:** `GET https://scrappa.co/api/bring-a-trailer/v1/listings/{id}`

## 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 |
| --- | --- | --- | --- |
| `id` | string | Yes | Listing ID from the search endpoint, e.g. 120648745, or the listing slug. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/bring-a-trailer/v1/listings/{id}?id=120648745"
```

## Example response

```json
{
    "success": true,
    "data": {
        "listing": {
            "id": 120648745,
            "title": "5k-Mile 2016 Ferrari 488 Spider",
            "year": 2016,
            "make": "Ferrari",
            "model": "Ferrari 488",
            "era": "2010s",
            "origin": "Italian",
            "category": "Convertibles",
            "location_country": "Located in United States",
            "essentials": {
                "location": "Lincoln, Nebraska 68512",
                "chassis": "ZFF80AMA2G0218545",
                "mileage": {
                    "value": 5000,
                    "unit": "mi"
                },
                "engine": "Twin-Turbocharged 3.9-Liter V8",
                "transmission": "Seven-Speed F1 Dual-Clutch Automatic Transaxle",
                "exterior_color": "Rosso Corsa Paint",
                "interior_color": "Beige Tradizione Leather Upholstery",
                "wheels": "20\" Split-Spoke Alloy Wheels",
                "other": [
                    "Scuderia Ferrari Fender Shields",
                    "Power-Retractable Hardtop",
                    "Parking Sensors",
                    "Power-Adjustable Daytona-Style Seats",
                    "JBL Sound System",
                    "Window Sticker",
                    "Service Records"
                ],
                "seller": "Private Party"
            },
            "lot": "#267872",
            "seller_type": "private",
            "bid": {
                "current": 180000,
                "count": 13,
                "ends_at": "2026-10-12T17:00:00+00:00"
            },
            "comments_count": 14,
            "images": [
                {
                    "id": 120583767,
                    "title": "5k-Mile 2016 Ferrari 488 Spider",
                    "large": {
                        "url": "https://bringatrailer.com/wp-content/uploads/2026/08/IMG_4251-scaled-65019.jpeg",
                        "width": 2048,
                        "height": 1536
                    },
                    "small": {
                        "url": "https://bringatrailer.com/wp-content/uploads/2026/08/IMG_4251-scaled-65019.jpeg?w=155&h=105&crop=1",
                        "width": 155,
                        "height": 105
                    }
                }
            ],
            "history": [],
            "fees": {
                "buyer_fee_percentage": 5,
                "buyer_fee_minimum": 250,
                "buyer_fee_maximum": 7500
            },
            "reserve": {
                "has_reserve": true,
                "reserve": null,
                "rnm_status": "not-started"
            },
            "permalink": "https://bringatrailer.com/listing/2016-ferrari-488-spider-14/",
            "post_status": "active"
        }
    },
    "meta": {
        "endpoint_family": "listing"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | A public parameter is invalid. This response is not billable. |  |
|  | Bring a Trailer rejected the request. This response is not billable. |  |
|  | Bring a Trailer returned an unexpected response. This response is not billable. |  |
|  | Bring a Trailer did not return usable data for this request. This response is not billable. |  |

## 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)