Get pending signature auctions
GET/api/auction/sign
Retrieves the list of closed auctions requiring signature by the company or carrier.Inclusion criteria:- Auctions in 'closed' status- With an assigned winner (bidWinner)- Where the company or the carrier has not yet signed- Ordered by closing date (most recent first)Optional query parameters:- page: Page number (default 1)- limit: Items per page (default value of ITEMS_PAGE in .env)- signedBy: Filter by pending signatory ('company' or 'trucker')Usage example:GET /api/auction/sign?page=1&limit=10&signedBy=companyThe response includes pagination and the basic fields for each auction.
Responses
- 200
- 400
- 401
Paginated list of auctions pending signature. Each item includes:- service_code: Unique identifier (e.g., VIGMURnT4FN)- status: 'closed'- bidWinner: Information of the winning carrier- signed_by_company/signed_by_trucker: Signature statuses- createdAt/closedAt: Relevant dates
Request error
Unauthorized