Cars & Bids Auction State API Documentation Poll the live state of one Cars & Bids auction by id: status, end time as ISO 8601 UTC, current bid in USD, high bidder, number of bids, comments, questions and watchers. A small, fast response for tracking an auction until it ends. Closed auctions return their final state. The counters are real counts, so 0 means none yet.
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",
"bids": 18,
"status": "reserve_not_met",
"watchers": 918,
"questions": 0,
"auction_end": "2026-10-14T19:57:00Z",
"current_bid": 83333,
"high_bidder": "r32fan",
"comments_count": 28
},
"meta": {
"billable": true,
"endpoint_family": "auction_state"
},
"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_state"
},
"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_state"
},
"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.