Skip to main content

Get pending signature auctions

GET 
/api/auction/sign

Retrieves the list of closed auctions that require signing 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=company

The response includes pagination and the basic fields for each auction.

Responses​

Paginated list of auctions pending signature. Each item includes:

  • service_code: Unique identifier (e.g., VIGMURnT4FN)
  • status: 'closed'
  • bidWinner: Winning carrier's information
  • signed_by_company/signed_by_trucker: Signature statuses
  • createdAt/closedAt: Relevant dates