Skip to main content

Get active auctions

GET 
/api/auction/active

Retrieves the list of active auctions available for bidding. Active auctions are those that:

  • Have a status of 'published'
  • The current date is between date_start and date_end
  • Have not been closed or cancelled

Optional query parameters:

  • page: Page number (default 1)
  • limit: Items per page (default value of ITEMS_PAGE in .env)
  • search: Text to search in service_code, etl_cargo_method, pallets_type, or description
  • status: Filter by status (draft, published, closed, cancelled)
  • minDate/maxDate: Date range for date_start or etl_date

Usage example:

GET /api/auction/active?page=1&limit=10&search=urgent

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

Responses​

Paginated list of active auctions. Each item includes:

  • service_code: Unique identifier
  • etl_date/etd_date: Load/discharge dates
  • status: Current status
  • cargo_height/cargo_weight: Dimensions
  • bid_current: Current bid (if exists)