Delete a bid
DELETE/company/bid-auctions/:service_code
Allows a user to delete a bid they previously placed, provided the auction has not yet been awarded.
Objective
Enable carriers to withdraw a bid before the auction is awarded, maintaining flexibility in the participation process.
Use Cases
- Carrier realizes they made an error in the bid amount
- Carrier is no longer available for the transport date
- Carrier found a better opportunity in another auction
- Error in the bid data that requires correction
Restrictions
- Only own bids can be deleted
- The auction must be in the 'published' state
- Requires JWT authentication
- Cannot be deleted if the auction has already been awarded
Usage Example:
DELETE /company/bid-auctions/TRANS-12345
Request
Responses
- 200
- 401
- 404
Bid successfully removed. Returns confirmation message.
Response Headers
Unauthorized. Possible causes:
- NO_TOKEN: Invalid or expired JWT token
- TOKEN_NOT_VALID: Token not valid for this user
- User is not the owner of the bid
Response Headers
Not found. Possible causes:
- SERVICE_CODE_NOT_PROVIDED: The service code does not exist
- BID_NOT_FOUND: The user has no bids in this auction