Skip to main content

Get carrier's favorite auctions

GET 

/truckers/auctions/favorites

Returns a paginated list of auctions that the carrier has marked as favorites.

Features:

  • Only shows authenticated user's favorite auctions
  • Includes auctions in all statuses (active, awarded, completed)
  • Maintains the order in which they were marked as favorites (most recent first)
  • Supports pagination to handle long lists

Important fields:

  • service_code: Unique auction identifier
  • status: Current status (published, awarded, approved, completed)
  • is_favorite: Always true (since these are the user's favorites)
  • favorite_date: Date when it was marked as favorite

Usage example:

  1. Carrier marks auctions as favorites from the list
  2. Queries this list to see only their favorites
  3. Can filter/sort as needed

Request

Responses

List of favorite auctions paginated

Response Headers