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.

BidAuc organizes jobs into service categories to help Seekers describe the type of work they need and to help Providers find relevant opportunities. This endpoint returns all 22 available categories in a single request. You do not need to be authenticated to call it, making it suitable for use in onboarding flows, job creation forms, and public-facing pages.

Endpoint

GET /category/getAllCategories

Authentication

None required.

Parameters

This endpoint takes no parameters.

Example request

curl --request GET \
  --url https://api.bidauc.com/category/getAllCategories

Success response

{
  "success": true,
  "message": "Categories was successfully retrieved",
  "categories": [
    {
      "_id": "64a0b1c2d3e4f5a6b7c8d9e0",
      "categoryName": "Plumbing",
      "image": "/uploads/categories/plumbing.jpg"
    },
    {
      "_id": "64a0b1c2d3e4f5a6b7c8d9e1",
      "categoryName": "Electrical Works",
      "image": "/uploads/categories/electrical-works.jpg"
    },
    {
      "_id": "64a0b1c2d3e4f5a6b7c8d9e2",
      "categoryName": "Carpentry",
      "image": "/uploads/categories/carpentry.jpg"
    }
  ]
}

All available categories

The platform currently provides 22 service categories:
  • Plumbing
  • Electrical Works
  • Carpentry
  • Painting
  • Appliance Repair
  • Residential Cleaning
  • Commercial Cleaning
  • Disinfection Services
  • Pool Cleaning and Maintenance
  • Lawn Care and Mowing
  • Gardening
  • Tree Trimming and Removal
  • Residential Moving
  • Commercial Moving
  • Packing and Unpacking
  • Welding
  • Metal Fabrication
  • Machinery Repair
  • Loading and Unloading
  • Pet Grooming
  • Water Damage Restoration
  • Fire Damage Restoration

Response fields

success
boolean
required
true when the categories were fetched successfully.
message
string
required
A human-readable status message.
categories
object[]
required
Array of all category documents.
Category names are case-sensitive. When referencing a category in job creation or filtering, use the exact categoryName string as returned by this endpoint (for example, "Electrical Works" not "electrical works" or "Electrical works").

Build docs developers (and LLMs) love