Skip to main content

Create a new bid

POST 
/company/bid-auctions/

Allows a carrier to place a bid on an available transport auction.

Objective​

Enable carriers to bid their price for a transport service, competing with other carriers to win the auction.

Use Cases​

  • Carrier found an interesting auction and wants to offer their service
  • Carrier wants to improve their previous bid with a lower amount
  • Integration with automated bidding systems

Validations​

  • The service must be in 'published' status
  • The amount must be positive and lower than the current lowest bid (if one exists)
  • The user must have carrier permissions
  • Bidding on one's own auctions is not allowed

Example request:

{
  service_code: TRANS-12345,
  amount: 850.50
}

Request​

Responses​

Auction created successfully. Returns the updated auction details.

Response Headers