# Cars & Bids Auction Detail API Documentation

<p><strong>Cars & Bids Auction Detail API Documentation</strong> Retrieve one Cars & Bids auction by id: title, year, make, model, VIN, mileage in miles, engine, transmission, body style, drive train, colors, title status, highlights, the seller notes and listing sections as plain text, the seller, the bidding summary (bids, comments count, questions, watchers, current bid, high bidder, sale amount, start and end time as ISO 8601 UTC) and all photos with category, width and height. Fields that the seller did not provide are left out.</p>

- **Documentation:** [https://scrappa.co/docs/carsandbids-api/carsandbids_auction](https://scrappa.co/docs/carsandbids-api/carsandbids_auction)
- **API group:** Cars & Bids API
- **Endpoint:** `GET https://scrappa.co/api/carsandbids/auction`

## 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 | The 8 character auction id from the search endpoint or the auction URL, e.g. KVQ8JYAP. |

## Example response

```json
{
    "data": {
        "id": "KVQ8JYAP",
        "url": "https://carsandbids.com/auctions/KVQ8JYAP",
        "vin": "SCCLEKAX7RHB11313",
        "make": "Lotus",
        "year": 2024,
        "model": "Emira",
        "title": "2024 Lotus Emira V6 First Edition",
        "engine": "3.5L Supercharged V6",
        "images": [
            {
                "url": "https://media.carsandbids.com/4822e9034b0b6b357b3f73fabdfc10e586c36f68/photos/exterior/rMXMWV6Z-d-vXXGk/edit/cVYO8.jpg?t=179045645154",
                "width": 3650,
                "height": 2433,
                "category": "exterior"
            },
            {
                "url": "https://media.carsandbids.com/4822e9034b0b6b357b3f73fabdfc10e586c36f68/photos/exterior/rMXMWV6Z-BdNRXL3/edit/I5crk.jpg?t=179045647592",
                "width": 2925,
                "height": 1950,
                "category": "exterior"
            }
        ],
        "seller": {
            "username": "CVAUTO",
            "is_certified_seller": false
        },
        "status": "reserve_not_met",
        "bidding": {
            "bids": 18,
            "watchers": 918,
            "questions": 0,
            "auction_end": "2026-10-14T19:57:00Z",
            "current_bid": 83333,
            "high_bidder": "r32fan",
            "auction_start": "2026-10-07T21:54:00Z",
            "comments_count": 28
        },
        "mileage": 2200,
        "location": "Fresno, CA 93722",
        "subtitle": "2k Miles, 6-Speed Manual, Toyota-Derived Supercharged V6, Seneca Blue",
        "equipment": "This Emira is a V6 First Edition. A partial list of notable equipment reported by the selling dealer includes:\n- 20-inch forged wheels\n- Touring suspension\n- Alcantara-trimmed upholstery\n- Heated and power-adjustable front seats\n- Digital instrument cluster\n-\u2026",
        "make_slug": "lotus",
        "body_style": "Coupe",
        "highlights": [
            "Clean Carfax history report",
            "Touring suspension",
            "Alcantara-trimmed upholstery"
        ],
        "model_slug": "emira",
        "no_reserve": false,
        "drive_train": "Rear-wheel drive",
        "other_items": "- 2 keys\n- Owner's manual",
        "seller_notes": "- The tires on this Lotus carry 2023 date codes.\n- The selling dealer notes that the windows of this Lotus have been tinted.",
        "title_status": "Clean (TX)",
        "transmission": "Manual",
        "exterior_color": "Seneca Blue",
        "interior_color": "Black",
        "highlights_text": "THIS... is a 2024 Lotus Emira V6 First Edition, finished in Seneca Blue with a black interior.\n- This Emira features the desirable 6-speed manual transmission, and the odometer currently displays approximately 2,200 miles.\n- This Lotus is offered with a clean\u2026",
        "ownership_history": "The selling dealer reportedly acquired this Emira in 2026.",
        "transmission_details": "6-Speed",
        "recent_service_history": "The attached Carfax history report shows that the following services have been performed:\n- September 2025 (1,409 miles): Engine oil and filter changed"
    },
    "meta": {
        "billable": true,
        "endpoint_family": "auction_detail"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. No upstream request is made and the response is not billable. |
| 404 | Auction Not Found | No Cars & Bids auction exists for this id. This response is not billable and is not retried. |
| 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)