Use this file to discover all available pages before exploring further.
Providers use these endpoints to manage their work pipeline on BidAuc. Once a Seeker accepts your bid, the job moves into your active queue. You can also retrieve your full bid history to track every job you have submitted a bid on, regardless of whether it was accepted. All endpoints on this page require authentication.For context on how a job reaches a Provider’s queue: a Provider submits a bid on a pending job, the Seeker accepts the bid, and the job’s bidStatus becomes "accepted" with the Provider’s ID stored on the job record.
Returns jobs where the authenticated Provider’s bid has been accepted and the job has not yet been completed. These are jobs in progress — bidStatus: "accepted" and completionStatus: "pending".Authentication: Required (JWT cookie)Parameters: None
curl --request GET \ --url https://api.bidauc.com/job/getProviderActiveJobs \ --cookie "token=<YOUR_JWT_TOKEN>"
Returns jobs where the authenticated Provider’s bid was accepted and the Seeker has since marked the job as completed — bidStatus: "accepted" and completionStatus: "completed".Authentication: Required (JWT cookie)Parameters: None
curl --request GET \ --url https://api.bidauc.com/job/getProviderCompletedJobs \ --cookie "token=<YOUR_JWT_TOKEN>"
Response
{ "success": true, "message": "Provider completed jobs retrieved successfully!", "jobs": [ { "_id": "664b3c1a8c3b2a001f4e7d22", "jobName": "Repaint living room walls", "category": { "_id": "663d0fa12b4e5c001a3d8b04", "categoryName": "Painting", "image": "/static/assets/categories/painting.jpg" }, "urgency": "Within a week", "description": "Two coats of eggshell white on all four walls of a 14x16 ft living room.", "postedBy": { "_id": "663a0cd12b4e5c001a3d7a00", "userName": "jane_homeowner", "email": "jane@example.com", "phoneNumber": "+1-555-0100", "role": "seeker" }, "completionStatus": "completed", "bidStatus": "accepted", "provider": "663f1bc42b4e5c001a3d9c55", "acceptedBid": "664e8a2f8c3b2a001f4e8f02", "timePosted": "2026-05-18T09:10:05.000Z" } ]}
Returns all bids submitted by the authenticated Provider, with each bid’s associated job fully populated (including the job’s category and poster). This endpoint is useful for reviewing bidding history and checking which bids are still pending acceptance.Unlike the other Provider endpoints — which query the job collection directly — this endpoint queries the bid collection and populates the nested job reference. The response therefore returns bid objects rather than job objects directly.Authentication: Required (JWT cookie)Parameters: None
curl --request GET \ --url https://api.bidauc.com/job/getProviderBidPostedJobs \ --cookie "token=<YOUR_JWT_TOKEN>"
A bid appearing in this response with bidStatus: "unaccepted" means the Seeker has not yet accepted any bid on that job, including yours. If bidStatus is "accepted" and the job appears in getProviderActiveJobs, your bid was the one chosen.