Get auction details
GET/api/auction/:serviceCode
Retrieves all details of a specific auction identified by its serviceCode.
Requirements:
- The user must belong to the company that owns the auction
- The auction must exist and not be deleted
Fields included in the response:
- All basic fields (serviceCode, status, dates)
- Complete load/unload information (etl/etd)
- List of bids placed (if any exist)
- Winner information (if the auction is closed)
- Associated documents (contracts, signatures)
Usage example:
GET /api/auction/ABC123
The response includes all fields of the Auction model plus populated relations.
Request
Responses
- 200
- 400
- 401
Complete auction details including:
- Basic information (serviceCode, status, dates)
- Load/unload addresses (etl/etd_address)
- Bid list (bids) with history
- Current winner (bidWinner) if applicable
- Associated documents (contracts, signatures)
Error processing the request. Possible causes:
- Invalid or missing serviceCode
- Incorrect parameter format
Unauthorized. The user does not have permission to view this auction. Valid authentication and membership in the owning company are required.