Search available auctions
GET/company/bid-auctions/
Endpoint for searching available transport auctions with advanced filters. Allows filtering by load/unload locations, cargo type, and pagination.
Objective
To facilitate carriers in finding published auctions that match their capabilities and routes of interest, optimizing the process of matching transport supply and demand.
Use Cases
- Carrier searching for available loads on a specific route (e.g., Madrid to Barcelona)
- Carrier with refrigerated vehicles looking for temperature-controlled cargo
- Companies checking active auctions in the market
- Integration with fleet management systems to automate load searches
Usage example:
GET /company/bid-auctions?addr_load=Madrid&addr_delivery=Barcelona&is_fresh=true&page=2
Request
Responses
- 200
- 400
- 401
Auctions found successfully. Returns an array of auctions with pagination metadata.
Response Headers
Invalid parameters. Possible causes:
- Incorrect page format or limit
- Invalid boolean value for is_fresh
Response Headers
Unauthorized. Invalid, expired, or missing JWT token.