Create a new bid
POST/truckers/auctions/bid
Allows a carrier to place a bid in an active auction.
Requirements:
- Authenticated and active user
- Verified and enabled payment account
- Auction in 'published' status
- Valid bid amount (greater than 0 and less than the current lowest bid)
- Carrier meets the auction requirements (vehicle type, capacity, etc.)
Typical Flow:
- Carrier queries available auctions
- Gets details of a specific auction
- Places a bid with a competitive amount
- If the bid is the lowest, it becomes the temporary winning bid
In case of a winning bid:
- The carrier and the shipper are notified
- The auction is locked for other bids if the award price is reached
Request
Responses
- 200
- 400
- 401
- 403
- 409
Auction created successfully.
Error in the request. Possible causes:
- Invalid bid amount
- Auction not found or invalid
- Bid does not meet requirements
Unauthorized
Access denied. Possible causes:
- User not active
- Payment account not verified
- No permission to bid in this auction
Conflict. Possible causes:
- Auction already awarded
- Lower bid already exists
- Time/location restrictions