Cars & Bids Auction Detail API Documentation 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.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
string
Required
The 8 character auction id from the search endpoint or the auction URL, e.g. KVQ8JYAP.
1234567890
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"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
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter is missing or invalid. No upstream request is made and the response is not billable.
{
"errors": {
"id": [
"An auction id is 8 letters and digits, e.g. KVQ8JYAP."
]
},
"message": "The request validation failed"
}Auction Not Found
No Cars & Bids auction exists for this id. This response is not billable and is not retried.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "auction_detail"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested Cars & Bids auction was not found."
},
"success": false
}Service Unavailable
The upstream service is temporarily unavailable. Please retry shortly.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "auction_detail"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Cars & Bids is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.