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 deletedFields 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/ABC123The response includes all fields of the Auction model plus populated relationships.
Request
Responses
- 200
- 400
- 401
Complete auction details including:- Basic information (serviceCode, status, dates)- Loading/unloading addresses (etl/etd_address)- List of bids with history- Current winner (bidWinner) if applicable- Associated documents (contracts, signatures)
Error processing the request. Possible causes:- Invalid or not found 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.