Skip to main content

Get my active auctions

GET 
/company/bid-auctions/mine

Returns a paginated list of all auctions in which the authenticated user has placed bids. Includes auctions in the 'published', 'awarded', 'approved', etc. statuses.

Objective​

Allow carriers to manage their active bids, review the status of their participations, and filter based on different criteria of interest.

Use Cases​

  • Carrier wants to see all their active bids
  • Filter auctions pending signature
  • Review won or lost auctions
  • View complete history of participations

Filter Diagram:

flowchart TD
  A[GET /mine?filter=X] --> B{Filter Type}

  B -->|all| C[All user bids]
  B -->|open| D[Published auctions<br/>date_end >= today<br/>status: published]
  B -->|to_sign| E[Awarded pending signature<br/>status: awarded<br/>signed_by_trucker: false]
  B -->|awarded| F[All awarded auctions<br/>status: awarded]
  B -->|closed| G[Closed auctions<br/>status: locked/canceled/rejected]
  B -->|lost| H[Lost auctions<br/>status: approved<br/>user is NOT winner]
  B -->|won| I[Won auctions<br/>status: approved<br/>user IS winner]

  C --> J[Return AuctionsResponse]
  D --> J
  E --> J
  F --> J
  G --> J
  H --> J
  I --> J

  style D fill:#90EE90
  style E fill:#FFD700
  style I fill:#87CEEB
  style H fill:#FFB6C1

Usage Example:

GET /company/bid-auctions/mine?filter=to_sign&page=1&limit=10

Notable Fields in the Response:

  • my_bid: Amount of the user's bid
  • bid_current: Current best bid
  • status: Current auction status

Request​

Responses​

Auction list retrieved successfully. Includes pagination metadata and an array of auctions with the user's bids.

Response Headers