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.

Creating a job listing on BidAuc makes your work visible to qualified service providers who can then submit competitive bids. This guide walks you through authenticating, selecting the right category, filling in job details, optionally uploading an image, and submitting your listing via the API.

​
Prerequisites

  • You must be registered and logged in as a Seeker.
  • A valid JWT token must be present in your token cookie. See the Generate OTP and Login API pages if you haven’t logged in yet.

​
Posting your job

1

Authenticate with OTP login

All job creation endpoints require a valid JWT session cookie. If you are not yet logged in, request a one-time password and then exchange it for a session token:
# Step 1 — Request OTP (phone number as 10-digit string)
curl -X POST http://localhost:5000/user/generateOtp \
  -H "Content-Type: application/json" \
  -d '{"phoneNumber": "9876543210"}'

# Step 2 — Log in with OTP
curl -X POST http://localhost:5000/user/login \
  -H "Content-Type: application/json" \
  -c cookies.txt \
  -d '{"phoneNumber": "9876543210", "otp": "123456"}'
The login response sets the token cookie. Pass -b cookies.txt on subsequent requests, or supply the cookie header directly.
2

Choose a category

Every job must belong to one of the 22 supported service categories. The value you send must match the categoryName exactly (case-sensitive).
CategoryCategory
PlumbingElectrical Works
CarpentryPainting
Appliance RepairResidential Cleaning
Commercial CleaningDisinfection Services
Pool Cleaning and MaintenanceLawn Care and Mowing
GardeningTree Trimming and Removal
Residential MovingCommercial Moving
Packing and UnpackingWelding
Metal FabricationMachinery Repair
Loading and UnloadingPet Grooming
Water Damage RestorationFire Damage Restoration
If the category name does not match an existing record, the request will fail.
3

Fill in job details

Prepare the following fields before submitting:
FieldRequiredDescription
jobNameYesShort, descriptive title for the job
categoryYesExact category name from the table above
urgencyNoUrgency level — e.g. low, medium, high
descriptionYesFull description of the work needed
additionalRequirementsNoAny extra requirements or preferences
The urgency field is surfaced to providers when they browse jobs. Setting the correct urgency level helps providers prioritize your listing and respond faster to time-sensitive work.
4

Upload a job image (optional)

Attaching a photo of the work site or problem area helps providers understand the scope of work before placing a bid. Images are sent as the jobImages file field in the multipart form. While optional, including at least one image consistently leads to more and better-quality bids.Images are stored server-side under ./public/static/Assets/uploads/jobImages.
5

Submit the job via POST /job/create

Send a multipart/form-data POST request with all required fields. Include your session cookie for authentication.
curl -X POST http://localhost:5000/job/create \
  -b cookies.txt \
  -F "jobName=Fix leaking kitchen sink" \
  -F "category=Plumbing" \
  -F "urgency=high" \
  -F "description=The pipe under the kitchen sink has been leaking for two days. Water is pooling in the cabinet below." \
  -F "additionalRequirements=Please bring your own tools and replacement parts." \
  -F "jobImages=@/path/to/photo.jpg"
A successful response looks like:
{
  "success": true,
  "message": "Job posted successfully!"
}

​
What happens next

Once submitted, your job enters a pending state and becomes visible to service providers on the platform. Providers can browse pending jobs, review your description and image, and submit bids with their offered price and a personal pitch. You will be able to review incoming bids from your seeker dashboard and accept the provider that best fits your needs. See Managing jobs for the full workflow.

Build docs developers (and LLMs) love

Get started for freeTalk to us