Get auction details
get_auction_detailsRetrieve complete details for a specific GovDeals auction by ID or URL, including current bid, bid count, closing time, pickup location, condition, fees, and vehicle specs.
Instructions
Full details for one auction: current bid and bid count, exact end time, selling agency, pickup location, buyer's premium, reserve status, condition, description, and for vehicles/equipment the year, make, model, mileage, engine hours and VIN.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"auction_id": "<auction_id>"
},
"name": "get_auction_details"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| auction_id | Yes | Auction id as returned by search_auctions (e.g. "govdeals:13292-1554"), or a full GovDeals asset URL. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Stable id to pass to get_auction_details, e.g. "govdeals:27018-390" | |
| url | Yes | ||
| city | Yes | ||
| state | Yes | Two-letter state where the item is located | |
| title | Yes | ||
| agency | Yes | Government agency selling the item | |
| ends_at | Yes | Auction end time, ISO 8601 UTC | |
| vehicle | Yes | Present when the item looks like a vehicle or equipment | |
| category | Yes | Category as labeled by GovDeals | |
| currency | Yes | ||
| quantity | Yes | ||
| warnings | Yes | ||
| bid_count | Yes | ||
| closes_in | Yes | Readable time left, e.g. "4 min", "1h 20m", "2d 3h", "closed" | |
| condition | Yes | ||
| image_url | Yes | ||
| is_closed | Yes | True when the auction has already ended | |
| extraction | Yes | How TinyFish produced this record: fetch = parsed from TinyFish Fetch; agent = TinyFish Agent; agent_fallback = Fetch parse failed and Agent was used (signals site drift). | |
| hours_left | Yes | Hours until the auction ends, computed when fetched | |
| current_bid | Yes | Current high bid (or starting bid if no bids) in USD | |
| description | Yes | ||
| reserve_met | Yes | ||
| starting_bid | Yes | ||
| payment_terms | Yes | ||
| pickup_location | Yes | ||
| buyer_premium_pct | Yes | Buyer's premium as a percent, e.g. 10 for 10% |