Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/harshalw2003/BidAuc/llms.txt

Use this file to discover all available pages before exploring further.

As a Provider, you compete for jobs by submitting bids. Each bid includes your offered price and a description of how you plan to fulfill the job. Seekers review all bids for their job and choose the most suitable provider. A job can receive multiple bids, so a clear and specific description increases your chances of being selected.

​
Endpoint

POST /bid/post

​
Authentication

Requires a valid JWT session cookie. The authenticated user must have the Provider role.

​
Request parameters

​
jobId
string
required
The ID of the job you are bidding on. The job must be open and not already have an accepted bid.
​
offerPrice
number
required
Your price offer for completing the job, in the platform’s base currency.
​
description
string
required
A description of the services you will provide. This is your pitch to the Seeker — be specific about your approach, timeline, and qualifications.

​
Example request

curl --request POST \
  --url https://api.bidauc.com/bid/post \
  --header 'Content-Type: application/json' \
  --cookie 'token=<your_jwt_token>' \
  --data '{
    "jobId": "64a1f2c3b4e5d6f7a8b9c0d1",
    "offerPrice": 250,
    "description": "I have 8 years of experience in residential plumbing. I can complete the pipe replacement within one day and will provide a 90-day warranty on all work."
  }'

​
Success response

{
  "success": true,
  "message": "Bid Posted Successfully",
  "bid": {
    "_id": "64b2e3d4c5f6a7b8c9d0e1f2",
    "job": "64a1f2c3b4e5d6f7a8b9c0d1",
    "offerPrice": 250,
    "description": "I have 8 years of experience in residential plumbing. I can complete the pipe replacement within one day and will provide a 90-day warranty on all work.",
    "postedBy": "64c3f4e5d6a7b8c9d0e1f2a3",
    "status": "unaccepted",
    "timePosted": "2024-07-15T10:30:00.000Z"
  }
}

​
Error response

{
  "success": false,
  "message": "Error posting Bid",
  "Error": "Cast to ObjectId failed for value \"invalid-id\" at path \"job\""
}

​
Response fields

​
success
boolean
required
true when the bid was created successfully, false on error.
​
message
string
required
A human-readable status message.
​
bid
object
The newly created bid document.
Write your bid description as if you are speaking directly to the Seeker. Mention your relevant experience, an estimated completion time, and any guarantees or warranties you offer. Bids with detailed, job-specific descriptions are far more likely to be accepted than generic ones.

Build docs developers (and LLMs) love

Get started for freeTalk to us