Get minimal bid information with costs
GET/company/bid-auctions/minimal/:service_code
Returns the estimated costs for placing a bid on an auction. Includes distance calculation, tolls, fuel, and platform fees.
Objective
Allow carriers to quickly calculate the estimated cost of a bid without having to load all the auction details.
Use Cases
- Quick verification of an auction's economic feasibility
- Integration with systems requiring lightweight responses
- Dashboard widgets with summarized information
- Profit margin calculation before bidding
Usage Example:
GET /company/bid-auctions/minimal/TRANS-12345
Note: This endpoint returns complete cost information, not just basic bid data. The name minimal refers to it being a lightweight response compared to obtaining the full auction.
Request
Responses
- 200
- 401
- 404
Cost information successfully obtained. Returns complete object with estimated cost breakdown.
Response Headers
Unauthorized. Possible causes:
- NO_TOKEN: Invalid or expired JWT token
- User not authenticated
Response Headers
Auction not found. Possible causes:
- The code does not exist
- The user does not have permission to view this auction