Search available auctions
GET/company/bid-auctions/
Endpoint para buscar subastas de transporte disponibles con filtros avanzados. Permite filtrar por ubicaciones de carga/descarga, tipo de carga y paginación.
Objetivo
Facilitar a los transportistas la búsqueda de subastas publicadas que coincidan con sus capacidades y rutas de interés, optimizando el proceso de encuentros entre oferta y demanda de transporte.
Casos de Uso
- Transportista buscando cargas disponibles en una ruta específica (ej: Madrid a Barcelona)
- Transportista con vehículos refrigerados buscando carga de temperatura controlada
- Empresas verificando subastas activas en el mercado
- Integración con sistemas de gestión de flotas para automatizar la búsqueda de cargas
Ejemplo de uso:
GET /company/bid-auctions?addr_load=Madrid&addr_delivery=Barcelona&is_fresh=true&page=2
Request
Responses
- 200
- 400
- 401
Subastas encontradas exitosamente. Devuelve array de subastas con metadatos de paginación.
Response Headers
Parámetros inválidos. Posibles causas:
- Formato de página o límite incorrecto
- Valor booleano inválido para is_fresh
Response Headers
No autorizado. Token JWT inválido, expirado o no proporcionado.