Search available auctions
GET/company/bid-auctions/
Endpoint para buscar subastas de transporte disponíveis com filtros avançados. Permite filtrar por localizações de carga/descarga, tipo de carga e paginação.
Objetivo
Facilitar aos transportadores a busca de leilões publicados que correspondam às suas capacidades e rotas de interesse, otimizando o processo de encontros entre oferta e demanda de transporte.
Casos de Uso
- Transportador buscando cargas disponíveis em uma rota específica (ex: Madrid a Barcelona)
- Transportador com veículos refrigerados buscando carga de temperatura controlada
- Empresas verificando leilões ativos no mercado
- Integração com sistemas de gestão de frotas para automatizar a busca de cargas
Exemplo de uso:
GET /company/bid-auctions?addr_load=Madrid&addr_delivery=Barcelona&is_fresh=true&page=2
Request
Responses
- 200
- 400
- 401
Leilões encontrados com sucesso. Retorna um array de leilões com metadados de paginação.
Response Headers
Parâmetros inválidos. Possíveis causas:
- Formato de página ou limite incorreto
- Valor booleano inválido para is_fresh
Response Headers
Não autorizado. Token JWT inválido, expirado ou não fornecido.